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 логическое |
| Указывает, является ли раздел активным и может ли он использоваться для запуска системы. Это свойство действительно только тогда, когда стиль раздела диска — MBR. |
| disk_number целое число | Номер диска обязателен для создания новых разделов. Комбинация disk_number и partition_number может использоваться для указания раздела вместо drive_letter, если необходимо. | |
| drive_letter строка | Используется для доступа к разделам, если disk_number и partition_number не указаны. Используйте auto для автоматического назначения буквы диска или букву от A до Z для ручного назначения буквы диска новому разделу. Если не указано, при создании нового раздела буква диска не назначается. | |
| gpt_type строка |
| Укажите тип раздела GPT, если стиль раздела диска — GPT. Это относится только к новым разделам. Это не относится к форматированию файловой системы разделов. |
| hidden логическое |
| Скрывает целевой раздел, делая его невидимым для диспетчера монтирования. |
| mbr_type строка |
| Укажите тип раздела MBR, если стиль раздела диска — MBR. Это относится только к новым разделам. Это не относится к форматированию файловой системы разделов. |
| offline логическое |
| Переводит раздел в автономный режим. Добавление точки монтирования (например, буквы диска) снова переведет раздел в онлайн-режим. |
| partition_number целое число | Используется вместе с disk_number для однозначной идентификации раздела. | |
| partition_size строка | Укажите размер раздела в 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 логическое |
| Делает раздел доступным только для чтения, ограничивая внесение изменений в раздел. |
| state строка |
| Используется для указания состояния раздела. Используйте 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) <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.10/collections/community/windows/win_partition_module.html
