Модуль community.windows.win_format – Форматирует существующий том или новый том на существующей разметке на Windows

Примечание

Этот модуль является частью коллекции community.windows (версия 2.3.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.windows.

Чтобы использовать его в книге задач, укажите: community.windows.win_format.

Описание
Параметры
Примечания
См. также
Примеры

Описание

Модуль community.windows.win_format форматирует существующий том или новый том на существующей разметке на Windows

Параметры

Параметр	Комментарии
allocation_unit_size целое число	Указывает размер кластера для использования при форматировании тома. Если размер кластера не указан при форматировании разметки, по умолчанию выбираются значения, основанные на размере разметки. Это значение должно быть кратно физическому размеру сектора диска.
compress булево	Включить сжатие на получившемся NTFS томе. Сжатие NTFS не поддерживается, где allocation_unit_size больше 4096. Варианты: `false` `true`
drive_letter строка	Используется для указания буквы диска для форматируемого тома.
file_system строка	Используется для указания файловой системы, которая будет использоваться при форматировании целевого тома. Варианты: `"ntfs"` `"refs"` `"exfat"` `"fat32"` `"fat"`
force булево	Укажите, следует ли принудительно форматировать тома, которые не созданы из новых разметки или если исходная и целевая файловые системы отличаются. Варианты: `false` ← (по умолчанию) `true`
full булево	Полное форматирование записывает на каждый сектор диска, занимает значительно больше времени по сравнению с обычным (быстрым) форматированием, и не рекомендуется для хранилищ с тонкими выделениями. Укажите `true` для полного форматирования. Варианты: `false` ← (по умолчанию) `true`
integrity_streams булево	Включить потоки целостности на результирующем томе ReFS. Варианты: `false` `true`
label строка	Используется для указания метки тома для форматирования.
large_frs булево	Указывает, что следует использовать расширенную файловую систему FRS. Варианты: `false` `true`
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_partition: Создание, изменение и удаление разделов на Windows Server.

Примеры

- 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)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_format_module.html