Модуль community.windows.win_partition – создание, изменение и удаление разделов на Windows Server

Примечание

Этот модуль является частью коллекции community.windows (версия 2.3.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.windows.

Для использования в playbook, укажите: community.windows.win_partition.

Краткое описание
Параметры
Примечания
Примеры

Краткое описание

Модуль community.windows.win_partition может создавать, изменять или удалять раздел на диске

Параметры

Параметр	Комментарии
active boolean	Указывает, является ли раздел активным и может ли он использоваться для запуска системы. Это свойство действительно только тогда, когда стиль раздела диска — MBR. Варианты: `false` `true`
disk_number integer	Номер диска обязателен для создания новых разделов. Комбинация disk_number и partition_number может использоваться для указания раздела вместо drive_letter, если необходимо.
drive_letter string	Используется для доступа к разделам, если disk_number и partition_number не указаны. Используйте `auto` для автоматического присвоения буквы диска или букву от A до Z для ручного присвоения буквы диска новому разделу. Если не указано, при создании нового раздела буква диска не присваивается.
gpt_type string	Укажите тип раздела GPT, если стиль раздела диска — GPT. Это относится только к новым разделам. Это не относится к форматированию файловой системы разделов. Варианты: `"system_partition"` `"microsoft_reserved"` `"basic_data"` `"microsoft_recovery"`
hidden boolean	Скрывает целевой раздел, делая его невидимым для менеджера монтирования. Варианты: `false` `true`
mbr_type string	Укажите тип раздела MBR, если стиль раздела диска — MBR. Это относится только к новым разделам. Это не относится к форматированию файловой системы разделов. Варианты: `"fat12"` `"fat16"` `"extended"` `"huge"` `"ifs"` `"fat32"`
offline boolean	Устанавливает раздел в автономный режим. Добавление точки монтирования (например, буквы диска) приведет к тому, что раздел снова станет доступным. Варианты: `false` `true`
partition_number integer	Используется вместе с disk_number для однозначной идентификации раздела.
partition_size string	Укажите размер раздела в B, KB, KiB, MB, MiB, GB, GiB, TB или TiB. Используйте -1, чтобы указать максимально поддерживаемый размер. Размер раздела обязателен для создания нового раздела, но не для обновления или удаления раздела. Десятичные префиксы СИ кило, мега, гига, тера и т. д. являются степенями 10^3 = 1000. Двоичные префиксы киби, меби, гиби, теби и т. д. соответственно относятся к соответствующей степени 2^10 = 1024. Таким образом, гигабайт (ГБ) составляет 1000000000 (1000^3) байт, а 1 гибибайт (GiB) — 1073741824 (1024^3) байта.
read_only boolean	Делает раздел доступным только для чтения, ограничивая внесение изменений в раздел. Варианты: `false` `true`
state string	Используется для указания состояния раздела. Используйте `absent` для указания, следует ли удалить раздел, и `present` для указания, следует ли создать или обновить раздел. Варианты: `"absent"` `"present"` ← (по умолчанию)

Примечания

Примечание

Для использования этого модуля требуется минимальная версия операционной системы 6.2. Чтобы проверить совместимость вашей ОС, см. https://docs.microsoft.com/en-us/windows/desktop/sysinfo/operating-system-version.
Этот модуль не может использоваться для удаления буквы диска, связанной с разделом, инициализации диска или форматирования файловой системы.
Идемпотентность работает только в том случае, если вы указываете букву диска или другие уникальные атрибуты, такие как комбинация номера диска и номера раздела.
Для получения дополнительной информации см. https://msdn.microsoft.com/en-us/library/windows/desktop/hh830524.aspx.

Примеры

- name: Create a partition with drive letter D and size 5 GiB
  community.windows.win_partition:
    drive_letter: D
    partition_size: 5 GiB
    disk_number: 1

- name: Resize previously created partition to it's maximum size and change it's drive letter to E
  community.windows.win_partition:
    drive_letter: E
    partition_size: -1
    partition_number: 1
    disk_number: 1

- name: Delete partition
  community.windows.win_partition:
    disk_number: 1
    partition_number: 1
    state: absent

Авторы

Varun Chopra (@chopraaa)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_partition_module.html