community.windows.win_format – Форматирует существующий том или новый том на существующем разделе в Windows
Примечание
Этот плагин является частью коллекции community.windows (версия 1.2.0).
Для его установки используйте: ansible-galaxy collection install community.windows.
Для использования в playbook, укажите: community.windows.win_format.
Описание
- Модуль community.windows.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 строка | Используется для указания пути к тому, который необходимо отформатировать. |
Примечания
Примечание
- Для использования этого модуля требуется Microsoft Windows Server 2012 или Microsoft Windows 8 или более поздней версии. Чтобы проверить совместимость вашей системы, см. https://docs.microsoft.com/en-us/windows/desktop/sysinfo/operating-system-version.
- Один из трех параметров (drive_letter, path и label) обязателен для идентификации целевого тома, но более одного параметра одновременно указывать нельзя.
- Этот модуль является идемпотентным, если force не указан и метки файловой системы сохраняются.
- Дополнительную информацию можно найти на странице https://docs.microsoft.com/en-us/previous-versions/windows/desktop/stormgmt/format-msft-volume
См. также
См. также
- community.windows.win_disk_facts
-
Официальная документация по модулю community.windows.win_disk_facts.
- community.windows.win_partition
-
Официальная документация по модулю community.windows.win_partition.
Примеры
- 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: Full format the newly created partition as NTFS and label it
community.windows.win_format:
drive_letter: D
file_system: NTFS
new_label: Formatted
full: True
Авторы
- 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_format_module.html
