Set-AzureDeployment
Modifie l’état, les paramètres de configuration ou le mode de mise à niveau d’un déploiement.
Remarque
Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.
Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.
Important
Services Cloud (classique) est désormais déconseillé pour les nouveaux clients et sera supprimé le 31 août 2024 pour tous les clients. Les nouveaux déploiements doivent utiliser le nouveau modèle de déploiement basé sur Azure Resource Manager Azure Cloud Services (support étendu) .
Syntaxe
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>] Description
L’applet de commande Set-AzureDeployment modifie l’état, les paramètres de configuration ou le mode de mise à niveau d’un déploiement Azure. Vous pouvez modifier l’état du déploiement en cours d’exécution ou suspendu. Vous pouvez modifier le fichier .cscfg pour le déploiement. Vous pouvez définir le mode de mise à niveau et mettre à jour les fichiers de configuration. Utilisez l’applet de commande Set-AzureWalkUpgradeDomain pour lancer une mise à niveau.
Exemples
Exemple 1 : Modifier l’état d’un déploiement
PS C:\> Set-AzureDeployment -Status -ServiceName "ContosoService" -Slot "Production" -NewStatus "Running"Cette commande définit l’état du déploiement du service nommé ContosoService dans l’environnement de production sur En cours d’exécution.
Exemple 2 : Affecter un autre fichier de configuration à un déploiement
PS C:\> Set-AzureDeployment -Config -ServiceName "ContosoService" -Slot "Staging" -Configuration "C:\Temp\MyServiceConfig.Cloud.csfg"Cette commande affecte un autre fichier de configuration pour le déploiement du service nommé ContosoService dans l’environnement intermédiaire.
Exemple 3 : Définir le mode de mise à niveau sur Auto
PS C:\> Set-AzureDeployment -Upgrade -ServiceName "ContosoService" -Mode Auto -Package "C:\packages\ContosoApp.cspkg" -Configuration "C:\Config\ContosoServiceConfig.Cloud.csfg"Cette commande définit le mode de mise à niveau sur Auto et spécifie un package de mise à niveau et un nouveau fichier de configuration.
Exemple 4 : Installer la configuration de l’extension dans un service
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"Cette commande installe la configuration de l’extension dans le service cloud spécifié et les applique aux rôles.
Paramètres
-Config
Spécifie que cette applet de commande modifie la configuration du déploiement.
| Type: | SwitchParameter |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Configuration
Spécifie le chemin complet d’un fichier de configuration .cscfg. Vous pouvez spécifier un fichier de configuration pour une modification de mise à niveau ou de configuration.
| Type: | String |
| Position: | 3 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ExtensionConfiguration
Spécifie un tableau d’objets de configuration d’extension.
| Type: | ExtensionConfigurationInput[] |
| Position: | 9 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Force
Indique que l’applet de commande effectue une mise à niveau forcée.
| Type: | SwitchParameter |
| Position: | 8 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InformationAction
Spécifie la façon dont cette applet de commande répond à un événement d’information.
Les valeurs valides pour ce paramètre sont :
- Continuer
- Ignorer
- Demander
- SilentlyContinue
- Stop
- Suspendre
| Type: | ActionPreference |
| Alias: | infa |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InformationVariable
Spécifie une variable d’informations.
| Type: | String |
| Alias: | iv |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Label
Spécifie une étiquette pour le déploiement mis à niveau.
| Type: | String |
| Position: | 6 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Mode
Spécifie le mode de mise à niveau. Les valeurs valides sont :
- Automatique
- Manuel
- Simultané
| Type: | String |
| Position: | 5 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-NewStatus
Spécifie l’état cible du déploiement. Les valeurs valides sont : En cours d’exécution et suspendues.
| Type: | String |
| Position: | 3 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Package
Spécifie le chemin complet d’un fichier de package de mise à niveau.
| Type: | String |
| Position: | 2 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Profile
Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.
| Type: | AzureSMProfile |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RoleName
Spécifie le nom du rôle à mettre à niveau.
| Type: | String |
| Position: | 7 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ServiceName
Spécifie le nom du service Azure du déploiement.
| Type: | String |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Slot
Spécifie l’environnement du déploiement à modifier. Les valeurs valides sont : Production et préproduction.
| Type: | String |
| Position: | 4 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Status
Spécifie que cette applet de commande modifie l’état du déploiement.
| Type: | SwitchParameter |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Upgrade
Spécifie que cette applet de commande met à niveau le déploiement.
| Type: | SwitchParameter |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |