community.windows.win_initialize_disk 模块 – 初始化 Windows Server 上的磁盘

注意

此模块是 community.windows 集合 (版本 2.3.0) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.windows。

要在 playbook 中使用它，请指定： community.windows.win_initialize_disk。

概要

参数

参数

注释

disk_number

整数

用于指定要初始化的磁盘的磁盘号。

force

布尔值

指定是否应强制初始化已初始化的磁盘。

选项

  • false ← (默认)

  • true

online

布尔值

如果磁盘处于脱机状态和/或只读状态，则将磁盘更新为联机状态且不为只读状态。

选项

  • false

  • true ← (默认)

path

字符串

用于指定要初始化的磁盘的路径。

style

字符串

要用于磁盘的分区样式。有效选项为 mbr 或 gpt。

选项

  • "gpt" ← (默认)

  • "mbr"

uniqueid

字符串

用于指定要初始化的磁盘的唯一 ID。

备注

注意

  • 三个参数 ( *disk_number*、*uniqueid* 和 *path*) 中的一个是必须的，用于识别目标磁盘，但不能同时指定多个参数。

  • 使用此模块需要最低 Server 2012 或 Windows 8 操作系统版本。

  • 如果未指定 *force*，则此模块是幂等的。

另请参见

另请参见

community.windows.win_disk_facts

显示目标主机的已连接磁盘和磁盘信息。

community.windows.win_partition

在 Windows Server 上创建、更改和删除分区。

community.windows.win_format

格式化 Windows 上现有卷或现有分区上的新卷。

示例

- name: Initialize a disk
  community.windows.win_initialize_disk:
    disk_number: 1

- name: Initialize a disk with an MBR partition style
  community.windows.win_initialize_disk:
    disk_number: 1
    style: mbr

- name: Forcefully initiallize a disk
  community.windows.win_initialize_disk:
    disk_number: 2
    force: true

作者

  • Brant Evans (@branic)