Set-AzureServiceExtension
Fügt einer Bereitstellung eine Clouddiensterweiterung hinzu.
Hinweis
Die in dieser Dokumentation referenzierten Cmdlets dienen zum Verwalten von älteren Azure-Ressourcen, die Azure Service Manager (ASM)-APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.
Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.
Wichtig
Cloud Services (klassisch) wurde für neue Kunden nun als veraltet gekennzeichnet und wird am 31. August 2024 für alle Kunden ausgemustert. In neuen Bereitstellungen sollte das neue auf Azure Resource Manager basierende Bereitstellungsmodell für Azure Cloud Services (erweiterter Support) verwendet werden.
Syntax
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>]
Beschreibung
Das Cmdlet Set-AzureServiceExtension fügt einer Bereitstellung eine Clouddiensterweiterung hinzu.
Beispiele
Beispiel 1: Hinzufügen eines Clouddiensts zu einer Bereitstellung
PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -ExtensionName "RDP" -Version "1.0" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;
Mit diesem Befehl wird einer Bereitstellung ein Clouddienst hinzugefügt.
Beispiel 2: Hinzufügen eines Clouddiensts zu einer Bereitstellung für eine bestimmte Rolle
PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -Role "WebRole1" -ExtensionName "RDP" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;
Mit diesem Befehl wird einer Bereitstellung für eine bestimmte Rolle ein Clouddienst hinzugefügt.
Parameter
-CertificateThumbprint
Gibt einen Zertifikatfingerabdruck an, der zum Verschlüsseln der privaten Konfiguration verwendet werden soll. Dieses Zertifikat muss bereits im Zertifikatspeicher vorhanden sein. Wenn Sie kein Zertifikat angeben, erstellt dieses Cmdlet ein Zertifikat.
Typ: | String |
Position: | 3 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExtensionId
Gibt die Erweiterungs-ID an.
Typ: | String |
Position: | 10 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExtensionName
Gibt den Erweiterungsnamen an.
Typ: | String |
Position: | 5 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InformationAction
Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.
Zulässige Werte für diesen Parameter:
- Weiter
- Ignorieren
- Inquire
- SilentlyContinue
- Beenden
- Angehalten
Typ: | ActionPreference |
Aliases: | infa |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Gibt eine Informationsvariable an.
Typ: | String |
Aliases: | iv |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateConfiguration
Gibt den Text für die private Konfiguration an.
Typ: | String |
Position: | 8 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
Typ: | AzureSMProfile |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProviderNamespace
Gibt den Namespace des Erweiterungsanbieters an.
Typ: | String |
Position: | 6 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublicConfiguration
Gibt den öffentlichen Konfigurationstext an.
Typ: | String |
Position: | 7 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Role
Gibt ein optionales Array von Rollen an, für die die Remotedesktopkonfiguration angegeben werden soll. Wenn dieser Parameter nicht angegeben ist, wird die Remotedesktopkonfiguration als Standardkonfiguration für alle Rollen angewendet.
Typ: | String[] |
Position: | 2 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceName
Gibt den Azure-Dienstnamen der Bereitstellung an.
Typ: | String |
Position: | 0 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Slot
Gibt die Umgebung der zu ändernden Bereitstellung an. Gültige Werte sind: Produktion oder Staging.
Typ: | String |
Position: | 1 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ThumbprintAlgorithm
Gibt den Hashingalgorithmus für Fingerabdruck an, der mit dem Fingerabdruck verwendet wird, um das Zertifikat zu identifizieren. Dieser Parameter ist optional, und der Standardwert ist sha1.
Typ: | String |
Position: | 4 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
Gibt die Erweiterungsversion an.
Typ: | String |
Position: | 9 |
Standardwert: | None |
Erforderlich: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-X509Certificate
Gibt ein X.509-Zertifikat an, das automatisch in den Clouddienst hochgeladen und zum Verschlüsseln der privaten Erweiterungskonfiguration verwendet wird.
Typ: | X509Certificate2 |
Position: | 3 |
Standardwert: | None |
Erforderlich: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |