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 programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.
Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.
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.
Typ: | String |
Position: | 3 |
wartość domyślna: | None |
Wymagane: | 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.
Typ: | PSCredential |
Position: | 5 |
wartość domyślna: | None |
Wymagane: | 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.
Typ: | DateTime |
Position: | 6 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExtensionId
Określa identyfikator rozszerzenia.
Typ: | String |
Position: | 8 |
wartość domyślna: | None |
Wymagane: | 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
- Zatrzymaj
- Wstrzymanie
Typ: | ActionPreference |
Aliases: | infa |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Określa zmienną informacyjną.
Typ: | String |
Aliases: | iv |
Position: | Named |
wartość domyślna: | None |
Wymagane: | 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.
Typ: | AzureSMProfile |
Position: | Named |
wartość domyślna: | None |
Wymagane: | 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.
Typ: | String[] |
Position: | 2 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceName
Określa nazwę usługi platformy Azure wdrożenia.
Typ: | String |
Position: | 0 |
wartość domyślna: | None |
Wymagane: | 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.
Typ: | String |
Position: | 1 |
wartość domyślna: | None |
Wymagane: | 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.
Typ: | String |
Position: | 4 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
Określa wersję rozszerzenia.
Typ: | String |
Position: | 7 |
wartość domyślna: | None |
Wymagane: | 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.
Typ: | X509Certificate2 |
Position: | 3 |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |