Set-AzureDeployment
Modifica lo stato, le impostazioni di configurazione o la modalità di aggiornamento di 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-AzureDeployment
[-Upgrade]
[-ServiceName] <String>
[-Package] <String>
[-Configuration] <String>
[-Slot] <String>
[[-Mode] <String>]
[[-Label] <String>]
[[-RoleName] <String>]
[-Force]
[[-ExtensionConfiguration] <ExtensionConfigurationInput[]>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureDeployment
[-Config]
[-ServiceName] <String>
[-Configuration] <String>
[-Slot] <String>
[[-ExtensionConfiguration] <ExtensionConfigurationInput[]>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureDeployment
[-Status]
[-ServiceName] <String>
[-Slot] <String>
[-NewStatus] <String>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Descrizione
Il cmdlet Set-AzureDeployment modifica lo stato, le impostazioni di configurazione o la modalità di aggiornamento di una distribuzione di Azure. È possibile modificare lo stato della distribuzione in Esecuzione o Sospeso. È possibile modificare il file con estensione cscfg per la distribuzione. È possibile impostare la modalità di aggiornamento e aggiornare i file di configurazione. Usare il cmdlet Set-AzureWalkUpgradeDomain per avviare un aggiornamento.
Esempio
Esempio 1: Modificare lo stato di una distribuzione
PS C:\> Set-AzureDeployment -Status -ServiceName "ContosoService" -Slot "Production" -NewStatus "Running"Questo comando imposta lo stato della distribuzione per il servizio denominato ContosoService nell'ambiente di produzione su In esecuzione.
Esempio 2: Assegnare un file di configurazione diverso a una distribuzione
PS C:\> Set-AzureDeployment -Config -ServiceName "ContosoService" -Slot "Staging" -Configuration "C:\Temp\MyServiceConfig.Cloud.csfg"Questo comando assegna un file di configurazione diverso per la distribuzione per il servizio denominato ContosoService nell'ambiente di gestione temporanea.
Esempio 3: Impostare la modalità di aggiornamento su Auto
PS C:\> Set-AzureDeployment -Upgrade -ServiceName "ContosoService" -Mode Auto -Package "C:\packages\ContosoApp.cspkg" -Configuration "C:\Config\ContosoServiceConfig.Cloud.csfg"Questo comando imposta la modalità di aggiornamento su Auto e specifica un pacchetto di aggiornamento e un nuovo file di configurazione.
Esempio 4: Installare la configurazione dell'estensione in un servizio
PS C:\> Set-AzureDeployment -Config -ServiceName "ContosoService" -Mode "Automatic" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -Slot "Production" -ExtensionConfiguration "C:\packages\ContosoExtensionConfig.cscfg"Questo comando installa la configurazione dell'estensione nel servizio cloud specificato e le applica ai ruoli.
Parametri
-Config
Specifica che questo cmdlet modifica la configurazione della distribuzione.
| Tipo: | SwitchParameter |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Configuration
Specifica il percorso completo di un file di configurazione con estensione cscfg. È possibile specificare un file di configurazione per un aggiornamento o una modifica della configurazione.
| Tipo: | String |
| Posizione: | 3 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ExtensionConfiguration
Specifica una matrice di oggetti di configurazione dell'estensione.
| Tipo: | ExtensionConfigurationInput[] |
| Posizione: | 9 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Force
Indica che il cmdlet esegue un aggiornamento forzato.
| Tipo: | SwitchParameter |
| Posizione: | 8 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| 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 |
-Label
Specifica un'etichetta per la distribuzione aggiornata.
| Tipo: | String |
| Posizione: | 6 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Mode
Specifica la modalità di aggiornamento. I valori validi sono:
- Auto
- Manuale
- Simultaneo
| Tipo: | String |
| Posizione: | 5 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-NewStatus
Specifica lo stato di destinazione per la distribuzione. I valori validi sono: In esecuzione e Sospeso.
| Tipo: | String |
| Posizione: | 3 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Package
Specifica il percorso completo di un file del pacchetto di aggiornamento.
| Tipo: | String |
| Posizione: | 2 |
| Valore predefinito: | None |
| Necessario: | True |
| 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 |
-RoleName
Specifica il nome del ruolo da aggiornare.
| Tipo: | String |
| Posizione: | 7 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ServiceName
Specifica il nome del servizio di Azure della distribuzione.
| Tipo: | String |
| Posizione: | 1 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Slot
Specifica l'ambiente della distribuzione da modificare. I valori validi sono: Produzione e Gestione temporanea.
| Tipo: | String |
| Posizione: | 4 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-Status
Specifica che questo cmdlet modifica lo stato della distribuzione.
| Tipo: | SwitchParameter |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Upgrade
Specifica che questo cmdlet aggiorna la distribuzione.
| Tipo: | SwitchParameter |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |