Set-AzureServiceRemoteDesktopExtension

  • Referenz
Modul:
Azure

Aktiviert die Remotedesktoperweiterung für bestimmte Rollen oder alle Rollen für einen bereitgestellten Dienst oder bei der Bereitstellung.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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-AzureServiceRemoteDesktopExtension
   [[-ServiceName] <String>]
   [[-Slot] <String>]
   [[-Role] <String[]>]
   [[-X509Certificate] <X509Certificate2>]
   [[-ThumbprintAlgorithm] <String>]
   [-Credential] <PSCredential>
   [[-Expiration] <DateTime>]
   [[-Version] <String>]
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureServiceRemoteDesktopExtension
   [[-ServiceName] <String>]
   [[-Slot] <String>]
   [[-Role] <String[]>]
   [-CertificateThumbprint] <String>
   [[-ThumbprintAlgorithm] <String>]
   [-Credential] <PSCredential>
   [[-Expiration] <DateTime>]
   [[-Version] <String>]
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureServiceRemoteDesktopExtension ermöglicht die Remotedesktoperweiterung für bestimmte Rollen oder alle Rollen für einen bereitgestellten Dienst oder bei der Bereitstellung.

Beispiele

Beispiel 1: Aktivieren der Remotedesktoperweiterung

PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $creds

Mit diesem Befehl wird die Remotedesktoperweiterung für den angegebenen Dienst aktiviert.

Beispiel 2: Aktivieren der Remotedesktoperweiterung für eine bestimmte Rolle

PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $creds -Role "WebRole1"

Mit diesem Befehl wird die Remotedesktoperweiterung für den angegebenen Dienst und die angegebene Rolle aktiviert.

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.

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

-Credential

Gibt die Anmeldeinformationen an, die für den Remotedesktop aktiviert werden sollen. Anmeldeinformationen umfassen einen Benutzernamen und ein Kennwort.

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

-Expiration

Gibt ein Datumszeitobjekt an, mit dem der Benutzer angeben kann, wann das Benutzerkonto abläuft.

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

-ExtensionId

Gibt die Erweiterungs-ID an.

Type:String
Position:8
Default value:None
Required:False
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:

  • Fortfahren
  • Ignorieren
  • Fragen
  • SilentlyContinue
  • Beenden
  • Angehalten
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Gibt eine Informationsvariable an.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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.

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

-ServiceName

Gibt den Azure-Dienstnamen der Bereitstellung an.

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

-Slot

Gibt die Umgebung der zu ändernden Bereitstellung an. Die zulässigen Werte für diesen Parameter sind: Production, Staging.

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

-ThumbprintAlgorithm

Gibt einen Fingerabdruckhashingalgorithmus an, der mit dem Fingerabdruck verwendet wird, um das Zertifikat zu identifizieren. Dieser Parameter ist optional, und der Standardwert ist sha1.

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

-Version

Gibt die Erweiterungsversion an.

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

-X509Certificate

Gibt ein x509-Zertifikat an, das automatisch in den Clouddienst hochgeladen und zum Verschlüsseln der privaten Konfiguration der Erweiterung verwendet wird.

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