win_partition – Создаёт, изменяет и удаляет разделы на сервере Windows
Новая версия с 2.8.
Обзор
- Модуль win_partition может создавать, изменять или удалять раздел на диске
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| active boolean |
| Указывает, является ли раздел активным и может ли он использоваться для загрузки системы. Это свойство применимо только в случае, если стиль разделов диска MBR. |
| disk_number integer | Номер диска обязателен для создания новых разделов. Для указания раздела вместо drive_letter можно использовать комбинацию disk_number и partition_number, если это необходимо. | |
| 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. Таким образом, гигабайт (GB) — это 1000000000 (1000^3) байт, в то время как 1 гибибайт (GiB) — это 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
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
win_partition:
drive_letter: E
partition_size: -1
partition_number: 1
disk_number: 1
- name: Delete partition
win_partition:
disk_number: 1
partition_number: 1
state: absent
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Данный модуль поддерживается сообществом Ansible. [community]
Авторы
- Varun Chopra (@chopraaa) <v@chopraaa.com>
Подсказка
Если вы обнаружили какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/win_partition_module.html
