community.windows.win_partition – Создаёт, изменяет и удаляет разделы на Windows Server
Примечание
Этот плагин входит в коллекцию community.windows (версия 1.2.0).
Для его установки используйте: ansible-galaxy collection install community.windows.
Для использования в playbook, укажите: community.windows.win_partition.
Обзор
- Модуль community.windows.win_partition может создавать, изменять или удалять раздел на диске
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| active boolean |
| Указывает, является ли раздел активным и может ли он использоваться для загрузки системы. Это свойство применимо только тогда, когда тип раздела диска — MBR. |
| disk_number integer | Номер диска обязателен для создания нового раздела. Сочетание disk_number и partition_number может использоваться для указания раздела вместо drive_letter, если это необходимо. | |
| drive_letter string | Используется для доступа к разделам, если disk_number и partition_number не указаны. Используйте auto для автоматического назначения буквы диска или букву от A до Z для ручного назначения буквы диска новому разделу. Если не указано, буква диска не назначается при создании нового раздела. | |
| gpt_type string |
| Укажите тип GPT раздела, если тип раздела диска — GPT. Это применимо только к новым разделам. Это не относится к форматированию файловой системы разделов. |
| hidden boolean |
| Скрывает целевой раздел, делая его невидимым для менеджера монтирования. |
| mbr_type string |
| Укажите тип MBR раздела, если тип раздела диска — MBR. Это применимо только к новым разделам. Это не относится к форматированию файловой системы разделов. |
| offline boolean |
| Выключает раздел. Добавление точки монтирования (например, буквы диска) снова включит раздел. |
| 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 гибибайт (ГБ) составляет 1073741824 (1024^3) байтов. | |
| read_only boolean |
| Сделать раздел только для чтения, ограничив возможность внесения изменений в раздел. |
| state string |
| Используется для указания состояния раздела. Используйте absent для указания, следует ли удалить раздел, и present для указания, следует ли создать или обновить раздел. |
Примечания
Примечание
- Для использования этого модуля требуется минимальная версия операционной системы 6.2. Чтобы проверить совместимость вашей ОС, см. https://docs.microsoft.com/ru-ru/windows/desktop/sysinfo/operating-system-version.
- Этот модуль не может использоваться для удаления буквы диска, связанной с разделом, инициализации диска или форматирования файловой системы.
- Идемпотентность работает только при указании буквы диска или других уникальных атрибутов, таких как сочетание номера диска и номера раздела.
- Дополнительную информацию см. на странице https://msdn.microsoft.com/ru-ru/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) <v@chopraaa.com>
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/windows/win_partition_module.html
