Share via

Set-AzureServiceExtension

  • Ссылка
Модуль:
Azure

Добавляет расширение облачной службы в развертывание.

Примечание.

Командлеты, приведенные в этой документации, предназначены для управления устаревшими ресурсами Azure, которые используют API-интерфейсами управления службами. Командлеты для управления ресурсами Azure Resource Manager см. в статье Модуль Az PowerShell.

Важно!

Облачные службы (классическая версия) объявлены устаревшими для новых клиентов. Их поддержка будет полностью прекращена 31 августа 2024 года. Для новых развертываний следует использовать Облачные службы Azure с расширенной поддержкой. Это новая модель развертывания на основе Azure Resource Manager.

Синтаксис

Set-AzureServiceExtension
   [[-ServiceName] <String>]
   [[-Slot] <String>]
   [[-Role] <String[]>]
   [[-X509Certificate] <X509Certificate2>]
   [[-ThumbprintAlgorithm] <String>]
   [-ExtensionName] <String>
   [-ProviderNamespace] <String>
   [-PublicConfiguration] <String>
   [-PrivateConfiguration] <String>
   [-Version] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureServiceExtension
   [[-ServiceName] <String>]
   [[-Slot] <String>]
   [[-Role] <String[]>]
   [-CertificateThumbprint] <String>
   [[-ThumbprintAlgorithm] <String>]
   [-ExtensionName] <String>
   [-ProviderNamespace] <String>
   [-PublicConfiguration] <String>
   [-PrivateConfiguration] <String>
   [-Version] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Описание

Командлет Set-AzureServiceExtension добавляет расширение облачной службы в развертывание.

Примеры

Пример 1. Добавление облачной службы в развертывание

PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -ExtensionName "RDP" -Version "1.0" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;

Эта команда добавляет облачную службу в развертывание.

Пример 2. Добавление облачной службы в развертывание для указанной роли

PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -Role "WebRole1" -ExtensionName "RDP" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;

Эта команда добавляет облачную службу в развертывание для указанной роли.

Параметры

-CertificateThumbprint

Указывает отпечаток сертификата, используемый для шифрования частной конфигурации. Этот сертификат уже должен существовать в хранилище сертификатов. Если сертификат не указан, этот командлет создает сертификат.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ExtensionId

Указывает идентификатор расширения.

Type:String
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ExtensionName

Указывает имя расширения.

Type:String
Position:5
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

Указывает, как этот командлет реагирует на событие сведений.

Ниже указаны допустимые значения этого параметра.

  • Продолжить
  • Пропустить
  • Узнать
  • SilentlyContinue
  • Stop
  • Приостановить
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Указывает переменную сведений.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateConfiguration

Задает текст частной конфигурации.

Type:String
Position:8
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProviderNamespace

Указывает пространство имен поставщика расширений.

Type:String
Position:6
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PublicConfiguration

Указывает текст общедоступной конфигурации.

Type:String
Position:7
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Role

Указывает необязательный массив ролей, для которых необходимо указать конфигурацию удаленного рабочего стола. Если этот параметр не указан, конфигурация удаленного рабочего стола применяется в качестве конфигурации по умолчанию для всех ролей.

Type:String[]
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceName

Указывает имя службы Azure для развертывания.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Slot

Указывает среду развертывания для изменения. Допустимые значения: Рабочая или промежуточная.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ThumbprintAlgorithm

Указывает алгоритм хэширования отпечатков, который используется с отпечатком для идентификации сертификата. Этот параметр является необязательным, а значение по умолчанию — sha1.

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Version

Указывает версию расширения.

Type:String
Position:9
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-X509Certificate

Указывает сертификат X.509, который автоматически отправляется в облачную службу и используется для шифрования частной конфигурации расширения.

Type:X509Certificate2
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False