Set-AzureServiceRemoteDesktopExtension

Włącza rozszerzenie pulpitu zdalnego dla określonych ról lub wszystkich ról w wdrożonej usłudze lub we wdrożeniu.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API zarządzania usługami. Zobacz moduł Az programu PowerShell, aby uzyskać polecenia cmdlet do zarządzania zasobami usługi Azure Resource Manager.

Ważne

Usługi Cloud Services (wersja klasyczna) są teraz przestarzałe dla nowych klientów i zostaną wycofane 31 sierpnia 2024 r. dla wszystkich klientów. Nowe wdrożenia powinny używać nowego modelu wdrażania opartego na usłudze Azure Resource Manager w usługach Azure Cloud Services (wsparcie dodatkowe).

Składnia

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>]

Opis

Polecenie cmdlet Set-AzureServiceRemoteDesktopExtension umożliwia rozszerzenie pulpitu zdalnego dla określonych ról lub wszystkich ról w wdrożonej usłudze lub we wdrożeniu.

Przykłady

Przykład 1. Włączanie rozszerzenia pulpitu zdalnego

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

To polecenie umożliwia rozszerzenie pulpitu zdalnego dla określonej usługi.

Przykład 2. Włączanie rozszerzenia pulpitu zdalnego dla określonej roli

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

To polecenie umożliwia rozszerzenie pulpitu zdalnego dla określonej usługi i roli.

Parametry

-CertificateThumbprint

Określa odcisk palca certyfikatu, który ma być używany do szyfrowania konfiguracji prywatnej. Ten certyfikat musi już istnieć w magazynie certyfikatów. Jeśli nie określisz certyfikatu, to polecenie cmdlet utworzy certyfikat.

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

-Credential

Określa poświadczenia, które mają być włączone dla pulpitu zdalnego. Poświadczenia obejmują nazwę użytkownika i hasło.

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

-Expiration

Określa obiekt daty i godziny, który umożliwia użytkownikowi określenie, kiedy wygasa konto użytkownika.

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

-ExtensionId

Określa identyfikator rozszerzenia.

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

-InformationAction

Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.

Dopuszczalne wartości tego parametru to:

  • Kontynuuj
  • Ignoruj
  • Zapytać
  • Silentlycontinue
  • Stop
  • Wstrzymanie
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Określa zmienną informacyjną.

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

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

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

-Role

Określa opcjonalną tablicę ról, dla których ma być określona konfiguracja pulpitu zdalnego. Jeśli ten parametr nie zostanie określony, konfiguracja pulpitu zdalnego zostanie zastosowana jako domyślna konfiguracja dla wszystkich ról.

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

-ServiceName

Określa nazwę usługi platformy Azure wdrożenia.

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

-Slot

Określa środowisko wdrożenia do zmodyfikowania. Dopuszczalne wartości tego parametru to: Produkcja, Przemieszczanie.

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

-ThumbprintAlgorithm

Określa algorytm wyznaczania wartości skrótu odcisku palca, który jest używany z odciskiem palca do identyfikowania certyfikatu. Ten parametr jest opcjonalny, a wartość domyślna to sha1.

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

-Version

Określa wersję rozszerzenia.

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

-X509Certificate

Określa certyfikat x509, który jest automatycznie przekazywany do usługi w chmurze i używany do szyfrowania prywatnej konfiguracji rozszerzenia.

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