Set-AzureServiceExtension
Aggiunge un'estensione del servizio cloud a 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.
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-AzureServiceExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-Role] <String[]>]
[[-X509Certificate] <X509Certificate2>]
[[-ThumbprintAlgorithm] <String>]
[-ExtensionName] <String>
[-ProviderNamespace] <String>
[-PublicConfiguration] <String>
[-PrivateConfiguration] <String>
[-Version] <String>
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureServiceExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-Role] <String[]>]
[-CertificateThumbprint] <String>
[[-ThumbprintAlgorithm] <String>]
[-ExtensionName] <String>
[-ProviderNamespace] <String>
[-PublicConfiguration] <String>
[-PrivateConfiguration] <String>
[-Version] <String>
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Descrizione
Il cmdlet Set-AzureServiceExtension aggiunge un'estensione del servizio cloud a una distribuzione.
Esempio
Esempio 1: Aggiungere un servizio cloud a una distribuzione
PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -ExtensionName "RDP" -Version "1.0" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;Questo comando aggiunge un servizio cloud a una distribuzione.
Esempio 2: Aggiungere un servizio cloud a una distribuzione per un ruolo specificato
PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -Role "WebRole1" -ExtensionName "RDP" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;Questo comando aggiunge un servizio cloud a una distribuzione per un ruolo specificato.
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 |
-ExtensionId
Specifica l'ID dell'estensione.
| Tipo: | String |
| Posizione: | 10 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-ExtensionName
Specifica il nome dell'estensione.
| Tipo: | String |
| Posizione: | 5 |
| Valore predefinito: | None |
| Necessario: | True |
| 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 |
-PrivateConfiguration
Specifica il testo di configurazione privato.
| Tipo: | String |
| Posizione: | 8 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| 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 |
-ProviderNamespace
Specifica lo spazio dei nomi del provider di estensioni.
| Tipo: | String |
| Posizione: | 6 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-PublicConfiguration
Specifica il testo di configurazione pubblico.
| Tipo: | String |
| Posizione: | 7 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| 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: | 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 validi sono: Produzione o Gestione temporanea.
| Tipo: | String |
| Posizione: | 1 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-ThumbprintAlgorithm
Specifica l'algoritmo di hash dell'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: | 9 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-X509Certificate
Specifica un certificato X.509 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 |