Расширение PowerShell DSC

Обзор

Расширение PowerShell DSC для Windows отправляет и применяет конфигурацию PowerShell DSC на виртуальной машине Azure. Расширение DSC вызывает PowerShell DSC для принятия полученной конфигурации DSC на виртуальной машине. В этом документе описаны поддерживаемые платформы, конфигурации и варианты развертывания для расширения виртуальной машины DSC для Windows.

Предпосылки

Операционная система

Расширение DSC поддерживает следующие операционные системы.

Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012R2, Windows Server 2012, Windows Server 2008 R2 с пакетом обновления 1 (SP1), Windows Client 7/8.1/10

Internet connectivity

Расширение DSC для Windows требует, чтобы целевая виртуальная машина могла взаимодействовать с Azure и расположением пакета конфигурации (.zip файла) при хранении за пределами Azure.

Схема расширения

В следующем формате JSON показана схема для части параметров расширения DSC в шаблоне Azure Resource Manager.

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "name": "Microsoft.Powershell.DSC",
  "apiVersion": "2018-10-01",
  "location": "<location>",
  "properties": {
    "publisher": "Microsoft.Powershell",
    "type": "DSC",
    "typeHandlerVersion": "2.77",
    "autoUpgradeMinorVersion": true,
    "settings": {
        "wmfVersion": "latest",
        "configuration": {
            "url": "http://validURLToConfigLocation",
            "script": "ConfigurationScript.ps1",
            "function": "ConfigurationFunction"
        },
        "configurationArguments": {
            "argument1": "Value1",
            "argument2": "Value2"
        },
        "configurationData": {
            "url": "https://foo.psd1"
        },
        "privacy": {
            "dataCollection": "enable"
        },
        "advancedOptions": {
            "forcePullAndApply": false,
            "downloadMappings": {
             "specificDependencyKey": "https://myCustomDependencyLocation"
            }
        }
    },
    "protectedSettings": {
        "configurationArguments": {
            "parameterOfTypePSCredential1": {
                "userName": "UsernameValue1",
                "password": "PasswordValue1"
            },
            "parameterOfTypePSCredential2": {
                "userName": "UsernameValue2",
                "password": "PasswordValue2"
            }
        },
        "configurationUrlSasToken": "?g!bber1sht0k3n",
        "configurationDataUrlSasToken": "?dataAcC355T0k3N"
    }
  }
}

Значения свойств

Параметры значений свойств

Значения свойств защищенных параметров

Развертывание шаблона

Расширения виртуальных машин Azure можно развернуть с помощью шаблонов Azure Resource Manager. Шаблоны идеально подходят при развертывании одной или нескольких виртуальных машин, требующих настройки после развертывания. Пример шаблона Resource Manager, который включает расширение DSC для Windows, можно найти в коллекции быстрого запуска Azure.

Устранение неполадок и поддержка

Troubleshoot

Данные о состоянии развертываний расширений можно получить на портале Azure и с помощью Azure CLI. Чтобы просмотреть состояние развертывания расширений для данной виртуальной машины, выполните следующую команду с помощью Azure CLI.

az vm extension list --resource-group myResourceGroup --vm-name myVM -o table

Пакет расширения скачан и развернут в этом расположении на виртуальной машине Azure

C:\Packages\Plugins\{Extension_Name}\{Extension_Version}

Файл состояния расширения содержит коды успешности и состояния и состояния, а также подробные ошибки и описание каждого запуска расширения.

C:\Packages\Plugins\{Extension_Name}\{Extension_Version}\Status\{0}.Status  -> {0} being the sequence number

Журналы выходных данных расширения записываются в следующий каталог:

C:\WindowsAzure\Logs\Plugins\{Extension_Name}\{Extension_Version}

Коды ошибок и их значения

Support

Если вам нужна дополнительная помощь в любой момент этой статьи, вы можете обратиться к экспертам Azure на форумах MSDN Azure и Stack Overflow. Кроме того, можно зарегистрировать обращение в службу поддержки Azure. Перейдите на сайт поддержки Azure и выберите "Получить поддержку". Дополнительные сведения об использовании службы поддержки Azure см. в статье "Часто задаваемые вопросы о поддержке Microsoft Azure".