Set-AzVMDscExtension
Настраивает расширение DSC на виртуальной машине.
Синтаксис
Default (по умолчанию)
Set-AzVMDscExtension
[-ResourceGroupName] <String>
[-VMName] <String>
[-Name <String>]
[-ArchiveBlobName] <String>
[-ArchiveStorageAccountName] <String>
[-ArchiveResourceGroupName <String>]
[-ArchiveStorageEndpointSuffix <String>]
[-ArchiveContainerName <String>]
[-ConfigurationName <String>]
[-ConfigurationArgument <Hashtable>]
[-ConfigurationData <String>]
[-Version] <String>
[-Force]
[-Location <String>]
[-AutoUpdate]
[-WmfVersion <String>]
[-DataCollection <String>]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Set-AzVMDscExtension настраивает расширение Windows PowerShell Desired State Configuration (DSC) на виртуальной машине в группе ресурсов.
Примеры
Пример 1. Установка расширения DSC
Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM07" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -Version "1.10" -Location "West US"
Эта команда задает расширение DSC на виртуальной машине с именем VM07, чтобы скачать Sample.ps1.zip из учетной записи хранения с именем Stg и контейнера по умолчанию.
Команда вызывает конфигурацию с именем ConfigName.
Файл Sample.ps1.zip ранее был отправлен с помощью Publish-AzVMDscConfiguration .
Пример 2. Настройка расширения DSC с данными конфигурации
Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM13" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName "WindowsPowerShellDSC" -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US"
Эта команда задает расширение виртуальной машины с именем VM13, чтобы скачать Sample.ps1.zip из учетной записи хранения с именем Stg и контейнера с именем WindowsPowerShellDSC.
Команда с именем ConfigName и указывает данные конфигурации и аргументы.
Файл Sample.ps1.zip ранее был отправлен с помощью Publish-AzVMDscConfiguration .
Пример 3. Настройка расширения DSC с данными конфигурации с автоматическим обновлением
Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM22" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName WindowsPowerShellDSC -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US" -AutoUpdate
Эта команда задает расширение виртуальной машины с именем VM22, чтобы скачать Sample.ps1.zip из учетной записи хранения с именем Stg и контейнера с именем WindowsPowerShellDSC.
Команда вызывает конфигурацию с именем ConfigName и задает данные конфигурации и аргументы.
Эта команда также включает автоматическое обновление обработчика расширений до последней версии.
Ранее Sample.ps1.zip был отправлен с помощью Publish-AzVMDscConfiguration .
Параметры
-ArchiveBlobName
Указывает имя файла конфигурации, который ранее был отправлен командлетом Publish-AzVMDscConfiguration.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False Aliases: ConfigurationArchiveBlob
Наборы параметров
(All)
Position: 5 Обязательно: True Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-ArchiveContainerName
Имя вида контейнера хранилища Azure, где находится архив конфигурации.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False Aliases: ИмяКонтейнера
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-ArchiveResourceGroupName
Указывает имя группы ресурсов, содержащей учетную запись хранения, содержащую архив конфигурации.
Этот параметр необязателен, если учетная запись хранения и виртуальная машина находятся в одной группе ресурсов.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-ArchiveStorageAccountName
Указывает имя учетной записи хранения Azure, которая используется для скачивания ArchiveBlobName.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False Aliases: Имя учетной записи хранения
Наборы параметров
(All)
Position: 4 Обязательно: True Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-ArchiveStorageEndpointSuffix
Указывает суффикс конечной точки хранилища.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False Aliases: StorageEndpointSuffix
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-AutoUpdate
Указывает версию обработчика расширений, указанную параметром Version .
По умолчанию обработчик расширений не выполняется автоматически.
Используйте параметр autoUpdate , чтобы включить автоматическое обновление обработчика расширений до последней версии, как и когда оно доступно.
Свойства параметра
Тип: SwitchParameter
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-ConfigurationArgument
Указывает хэш-таблицу, содержащую аргументы функции конфигурации.
Свойства параметра
Тип: Hashtable
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-ConfigurationData
Указывает путь к PSD1-файлу, который указывает данные для конфигурации.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-ConfigurationName
Указывает имя конфигурации, вызываемой расширением DSC.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметра
Тип: SwitchParameter
Default value: False Поддерживаются подстановочные знаки: False DontShow: False Aliases: cf
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-DataCollection
Указывает тип сбора данных.
Допустимые значения для этого параметра: включение и отключение.
Свойства параметра
Тип: String
Default value: None Допустимые значения: Enable, Disable Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Свойства параметра
Тип: IAzureContextContainer
Default value: None Поддерживаются подстановочные знаки: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-Force
Принудительно выполняется команда без запроса подтверждения пользователя.
Свойства параметра
Тип: SwitchParameter
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-Location
Указывает путь расширения ресурса.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-Name
Указывает имя ресурса Azure Resource Manager, представляющего расширение.
Значением по умолчанию является Microsoft.Powershell.DSC.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-NoWait
Запускает операцию и возвращается немедленно перед завершением операции. Чтобы определить, успешно ли выполнена операция, используйте другой механизм.
Свойства параметра
Тип: SwitchParameter
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-ResourceGroupName
Указывает имя группы ресурсов виртуальной машины.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: 2 Обязательно: True Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-Version
Указывает версию расширения DSC, к которому Set-AzVMDscExtension применяется параметры.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False Aliases: HandlerVersion
Наборы параметров
(All)
Position: 1 Обязательно: True Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-VMName
Указывает имя виртуальной машины, в которой установлен обработчик расширения DSC.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: 3 Обязательно: True Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-WhatIf
Показывает, что произойдет, если командлет будет запущен.
Командлет не запускается.
Свойства параметра
Тип: SwitchParameter
Default value: False Поддерживаются подстановочные знаки: False DontShow: False Aliases: wi
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-WmfVersion
Указывает версию WMF.
Свойства параметра
Тип: String
Default value: None Допустимые значения: 4.0, 5.0, 5.1, latest Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters .
Выходные данные
