win_partition – Создание, изменение и удаление разделов на серверах Windows
Новая версия 2.8.
Обзор
- Модуль win_partition может создавать, изменять или удалять разделы на диске
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| active boolean |
| Указывает, является ли раздел активным и может ли он использоваться для загрузки системы. Это свойство применимо только в том случае, если стиль разделов диска — MBR. |
| disk_number целое число | Номер диска обязателен для создания новых разделов. Комбинация disk_number и partition_number может использоваться для указания раздела вместо drive_letter, если это необходимо. | |
| drive_letter строка | Используется для доступа к разделам, если disk_number и partition_number не указаны. Используйте auto для автоматического назначения буквы диска или буквы A-Z для ручного назначения буквы диска новому разделу. Если не указано, буква диска не назначается при создании нового раздела. | |
| gpt_type строка |
| Укажите тип GPT раздела, если стиль разделов диска — GPT. Это применимо только к новым разделам. Это не относится к форматированию файловой системы разделов. |
| hidden boolean |
| Скрывает целевой раздел, делая его невидимым для менеджера монтирования. |
| mbr_type строка |
| Укажите тип MBR раздела, если стиль разделов диска — MBR. Это применимо только к новым разделам. Это не относится к форматированию файловой системы разделов. |
| offline boolean |
| Отключает раздел. Добавление точки монтирования (например, буквы диска) приведет к тому, что раздел снова станет доступным. |
| partition_number целое число | Используется вместе с disk_number для уникальной идентификации раздела. | |
| partition_size строка | Укажите размер раздела в 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 строка |
| Используется для указания состояния раздела. Используйте 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.8/modules/win_partition_module.html
