New-AzureServiceRemoteDesktopExtensionConfig
Generuje konfigurację rozszerzenia pulpitu zdalnego dla wdrożenia.
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.
Składnia
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>]
Opis
Polecenie cmdlet New-AzureServiceRemoteDesktopExtensionConfig generuje konfigurację rozszerzenia pulpitu zdalnego dla wdrożenia.
Przykłady
Przykład 1. Generowanie konfiguracji rozszerzenia pulpitu zdalnego
PS C:\> $rdpConfig = New-AzureServiceRemoteDesktopExtensionConfig -Credential $cred
To polecenie generuje konfigurację rozszerzenia pulpitu zdalnego dla określonych poświadczeń.
Przykład 2. Generowanie konfiguracji rozszerzenia pulpitu zdalnego dla określonej roli
PS C:\> $rdpConfig = New-AzureServiceRemoteDesktopExtensionConfig -Credential $cred -Role "WebRole01"
To polecenie generuje konfigurację rozszerzenia pulpitu zdalnego dla określonych poświadczeń i roli WebRole01.
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: | 1 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | 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: | 3 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Expiration
Określa obiekt DateTime , który umożliwia użytkownikowi określenie, kiedy wygasa konto użytkownika.
Typ: | DateTime |
Position: | 4 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-ExtensionId
Określa identyfikator rozszerzenia.
Typ: | String |
Position: | 6 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | 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 |
Aliasy: | infa |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-InformationVariable
Określa zmienną informacyjną.
Typ: | String |
Aliasy: | iv |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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: | 0 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | 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: | 2 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Version
Określa wersję rozszerzenia.
Typ: | String |
Position: | 5 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-X509Certificate
Określa certyfikat x509, który po określeniu zostanie automatycznie przekazany do usługi w chmurze i używany do szyfrowania konfiguracji prywatnej rozszerzenia.
Typ: | X509Certificate2 |
Position: | 1 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |