Condividi tramite


New-AzureServiceRemoteDesktopExtensionConfig

Genera una configurazione dell'estensione desktop remoto per una distribuzione.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

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

Descrizione

Il cmdlet New-AzureServiceRemoteDesktopExtensionConfig genera una configurazione per un'estensione desktop remoto per una distribuzione.

Esempio

Esempio 1: Generare una configurazione dell'estensione desktop remoto

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

Questo comando genera una configurazione dell'estensione desktop remoto per le credenziali specificate.

Esempio 2: Generare una configurazione dell'estensione desktop remoto per un ruolo specificato

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

Questo comando genera una configurazione dell'estensione desktop remoto per le credenziali specificate e il ruolo WebRole01.

Parametri

-CertificateThumbprint

Specifica un'identificazione personale del certificato da usare per crittografare la configurazione privata. Questo certificato deve essere già presente nell'archivio certificati. Se non si specifica un certificato, questo cmdlet crea un certificato.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Credential

Specifica le credenziali da abilitare per desktop remoto. Le credenziali includono un nome utente e una password.

Tipo:PSCredential
Posizione:3
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Expiration

Specifica un oggetto DateTime che consente all'utente di specificare quando scade l'account utente.

Tipo:DateTime
Posizione:4
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ExtensionId

Specifica l'ID dell'estensione.

Tipo:String
Posizione:6
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-InformationAction

Specifica la modalità di risposta di questo cmdlet a un evento informativo.

I valori validi per questo parametro sono:

  • Continua
  • Ignora
  • Inquire
  • SilentlyContinue
  • Arresta
  • Sospendi
Tipo:ActionPreference
Alias:infa
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InformationVariable

Specifica una variabile di informazioni.

Tipo:String
Alias:iv
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Role

Specifica una matrice facoltativa di ruoli per cui specificare la configurazione di Desktop remoto. Se questo parametro non viene specificato, la configurazione desktop remoto viene applicata come configurazione predefinita per tutti i ruoli.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ThumbprintAlgorithm

Specifica un algoritmo hash di identificazione personale usato con l'identificazione personale per identificare il certificato. Questo parametro è facoltativo e il valore predefinito è sha1.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Version

Specifica la versione dell'estensione.

Tipo:String
Posizione:5
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-X509Certificate

Specifica un certificato x509 che, quando specificato, verrà caricato automaticamente nel servizio cloud e usato per crittografare la configurazione privata dell'estensione.

Tipo:X509Certificate2
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False