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)