Condividi tramite

Set-AzureServiceRemoteDesktopExtension

  • Riferimento
Modulo:
Azure

Abilita l'estensione desktop remoto nei ruoli specificati o in tutti i ruoli in un servizio distribuito o in fase di 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.

Importante

Servizi cloud (versione classica) è ora deprecato per i nuovi clienti e verrà ritirato il 31 agosto 2024 per tutti i clienti. Le nuove distribuzioni devono usare il nuovo modello di distribuzione basato su Azure Resource Manager Azure Servizi cloud (supporto esteso).

Sintassi

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

Descrizione

Il cmdlet Set-AzureServiceRemoteDesktopExtension abilita l'estensione desktop remoto nei ruoli specificati o in tutti i ruoli in un servizio distribuito o in fase di distribuzione.

Esempio

Esempio 1: Abilitare l'estensione desktop remoto

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

Questo comando abilita l'estensione desktop remoto per il servizio specificato.

Esempio 2: Abilitare l'estensione desktop remoto per un ruolo specificato

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

Questo comando abilita l'estensione desktop remoto per il servizio e il ruolo specificati.

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:3
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:5
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Expiration

Specifica un oggetto data e ora che consente all'utente di specificare quando scade l'account utente.

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

-ExtensionId

Specifica l'ID dell'estensione.

Tipo:String
Posizione:8
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 di Desktop remoto viene applicata come configurazione predefinita per tutti i ruoli.

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

-ServiceName

Specifica il nome del servizio di Azure della distribuzione.

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

-Slot

Specifica l'ambiente della distribuzione da modificare. I valori accettabili per questo parametro sono: Produzione, Gestione temporanea.

Tipo:String
Posizione:1
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:4
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Version

Specifica la versione dell'estensione.

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

-X509Certificate

Specifica un certificato x509 caricato automaticamente nel servizio cloud e usato per crittografare la configurazione privata dell'estensione.

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