win_format – Форматирует существующий том или новый том на существующей разметке на Windows
Новая версия 2.8.
Описание
- Модуль win_format форматирует существующий том или новый том на существующей разметке на Windows
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| allocation_unit_size целое число | Указывает размер кластера для использования при форматировании тома. Если размер кластера не указан при форматировании разметки, значения по умолчанию выбираются на основе размера разметки. | |
| compress логическое значение |
| Включить сжатие на получившемся NTFS томе. Сжатие NTFS не поддерживается, если allocation_unit_size больше 4096. |
| drive_letter строка | Используется для указания буквы диска форматируемого тома. | |
| file_system строка |
| Используется для указания файловой системы, которая должна использоваться при форматировании целевого тома. |
| force логическое значение |
| Указывает, нужно ли форматировать тома, которые не созданы из новых разметок, или если исходная и целевая файловые системы отличаются. |
| full логическое значение |
| Полное форматирование записывает на каждый сектор диска, занимает гораздо больше времени, чем стандартное (быстрое) форматирование, и не рекомендуется для хранилищ с тонким выделением ресурсов. Укажите true для полного форматирования. |
| integrity_streams логическое значение |
| Включить целостность потоков на получившемся томе ReFS. |
| label строка | Используется для указания метки форматируемого тома. | |
| large_frs логическое значение |
| Указывает, что следует использовать большую файловую систему (FRS). |
| new_label строка | Используется для указания новой метки файловой системы форматируемого тома. | |
| path строка | Используется для указания пути к форматируемому тому. |
Примечания
Примечание
- Один из трех параметров (drive_letter, path и label) является обязательным для идентификации целевого тома, но более одного одновременно не может быть указано.
- Этот модуль является идемпотентным, если force не указан и метки файловой системы сохраняются.
- Дополнительную информацию см. в https://docs.microsoft.com/en-us/previous-versions/windows/desktop/stormgmt/format-msft-volume
См. также
См. также
- win_disk_facts – Отобразить подключенные диски и информацию о диске целевого хоста
- Официальная документация по модулю win_disk_facts.
- win_partition – Создает, изменяет и удаляет разметки на сервере Windows
- Официальная документация по модулю win_partition.
Примеры
- 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: Full format the newly created partition as NTFS and label it
win_format:
drive_letter: D
file_system: NTFS
new_label: Formatted
full: True
Статус
- Интерфейс этого модуля не гарантирует обратной совместимости. [превью]
- Этот модуль поддерживается сообществом 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_format_module.html
