Freigeben über

New-AzureServiceRemoteDesktopExtensionConfig

  • Referenz
Modul:
Azure

Generiert eine Remotedesktoperweiterungskonfiguration für eine Bereitstellung.

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.

Syntax

New-AzureServiceRemoteDesktopExtensionConfig
   [[-Role] <String[]>]
   [[-X509Certificate] <X509Certificate2>]
   [[-ThumbprintAlgorithm] <String>]
   [-Credential] <PSCredential>
   [[-Expiration] <DateTime>]
   [[-Version] <String>]
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureServiceRemoteDesktopExtensionConfig
   [[-Role] <String[]>]
   [-CertificateThumbprint] <String>
   [[-ThumbprintAlgorithm] <String>]
   [-Credential] <PSCredential>
   [[-Expiration] <DateTime>]
   [[-Version] <String>]
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzureServiceRemoteDesktopExtensionConfig generiert eine Konfiguration für eine Remotedesktoperweiterung für eine Bereitstellung.

Beispiele

Beispiel 1: Generieren einer Remotedesktoperweiterungskonfiguration

PS C:\> $rdpConfig = New-AzureServiceRemoteDesktopExtensionConfig -Credential $cred

Dieser Befehl generiert eine Remotedesktoperweiterungskonfiguration für die angegebenen Anmeldeinformationen.

Beispiel 2: Generieren einer Remotedesktoperweiterungskonfiguration für eine bestimmte Rolle

PS C:\> $rdpConfig = New-AzureServiceRemoteDesktopExtensionConfig -Credential $cred -Role "WebRole01"

Dieser Befehl generiert eine Remotedesktoperweiterungskonfiguration für die angegebenen Anmeldeinformationen und die WebRole01-Rolle.

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:1
Standardwert:None
Erforderlich: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.

Typ:PSCredential
Position:3
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-Expiration

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

Typ:DateTime
Position:4
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-ExtensionId

Gibt die Erweiterungs-ID an.

Typ:String
Position:6
Standardwert:None
Erforderlich: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:

  • 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

-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

-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:0
Standardwert:None
Erforderlich: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.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-Version

Gibt die Erweiterungsversion an.

Typ:String
Position:5
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False

-X509Certificate

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

Typ:X509Certificate2
Position:1
Standardwert:None
Erforderlich:False
Accept pipeline input:True
Accept wildcard characters:False