Руководство по миграции
Некоторые модули этой коллекции перенесены из коллекции community.windows. В этом документе описаны некоторые изменения, призванные упростить переход со старых модулей на модули этой коллекции.
Перенесённые модули
Следующие модули в той или иной форме перенесены в эту коллекцию
-
community.windows.win_iis_website->microsoft.iis.website- подробности -
community.windows.win_iis_webbinding->microsoft.iis.website- подробности -
community.windows.win_iis_virtualdirectory->microsoft.iis.virtual_directory- подробности -
community.windows.win_iis_webapppool->microsoft.iis.web_app_pool- подробности -
community.windows.win_iis_webapplication->microsoft.iis.web_application- подробности
Хотя эти модули в основном совместимы с прежними версиями и могут использоваться вместо них без изменений, есть некоторые критические изменения, которые необходимо учитывать. Дополнительные сведения см. в описании каждого модуля.
Модуль win_iis_website
Перенесён в microsoft.iis.website.
Следующие параметры удалены:
-
parameters— В настоящее время не реализован в новом модуле -
hostname,ip,port— Перенесены в параметрbindings. Дополнительные сведения см. в разделе подробности
Возвращаемые значения также удалены; вместо них следует использовать модуль microsoft.iis.website_info.
В этом примере показано, как веб-сайт задавался в старом модуле и как эквивалентное определение выглядит в новом модуле:
- name: Build website in win_iis_webbinding
community.windows.win_iis_website:
name: Acme
state: started
ip: 127.0.0.1
port: 80
application_pool: acme
physical_path: C:\sites\acme
- name: Build website in microsoft.iis.website
microsoft.iis.website:
name: Acme
state: started
bindings:
set:
- ip: 127.0.0.1
port: 80
application_pool: acme
physical_path: C:\sites\acme
Модуль win_iis_webbinding
Перенесён в microsoft.iis.website.
Модуль полностью удалён, а его функциональность объединена с модулем microsoft.iis.website. Теперь привязки задаются параметром bindings модуля веб-сайта. С его помощью можно за одну операцию добавить, удалить или задать несколько привязок для веб-сайта. Хотя большинство элементов bindings имеют тот же формат, что и в старом модуле, некоторые элементы привязки изменились:
-
host_header— Переименован вhostname -
ssl_flags— Разделён наuse_sniиuse_ccs -
state— Управляется заданием привязки в соответствующем ключеadd,remoteилиset
Модуль win_iis_virtualdirectory
Перенесён в microsoft.iis.virtual_directory.
Новый модуль microsoft.iis.virtual_directory практически не отличается от старого, за исключением удаления возвращаемых значений. Для получения сведений о виртуальных каталогах можно использовать новый модуль microsoft.iis.virtual_directory_info.
Модуль win_iis_webapppool
Перенесён в microsoft.iis.web_app_pool.
Новый модуль microsoft.iis.web_app_pool практически не отличается от старого, за исключением удаления возвращаемых значений. Для получения сведений о пулах веб-приложений можно использовать новый модуль microsoft.iis.web_app_pool_info.
Модуль win_iis_webapplication
Перенесён в microsoft.iis.web_application.
Новый модуль microsoft.iis.web_application практически не отличается от старого, за исключением удаления возвращаемых значений. Для получения сведений о веб-приложениях можно использовать новый модуль microsoft.iis.web_application_info.
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/microsoft/iis/docsite/guide_migration.html