New-AzureDeployment

  • Référence
Module:
Azure

Crée un déploiement à partir d’un service.

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

New-AzureDeployment
   [-ServiceName] <String>
   [-Package] <String>
   [-Configuration] <String>
   [-Slot] <String>
   [[-Label] <String>]
   [[-Name] <String>]
   [-DoNotStart]
   [-TreatWarningsAsError]
   [-ExtensionConfiguration <ExtensionConfigurationInput[]>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande New-AzureDeployment crée un déploiement Azure à partir d’un service qui comprend des rôles web et des rôles de travail. Cette applet de commande crée un déploiement basé sur un fichier de package (.cspkg) et un fichier de configuration de service (.cscfg). Spécifiez un nom unique dans l’environnement de déploiement.

Utilisez l’applet de commande New-AzureVM pour créer un déploiement basé sur des machines virtuelles Azure.

Exemples

Exemple 1 : Créer un déploiement

PS C:\> New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -Label "ContosoDeployment"

Cette commande crée un déploiement de production basé sur un package nommé ContosoPackage.cspkg et une configuration nommée ContosoConfiguration.cscfg. La commande spécifie une étiquette pour le déploiement. Il ne spécifie pas de nom. Cette applet de commande crée un GUID comme nom.

Exemple 2 : Créer un déploiement basé sur une configuration d’extension

PS C:\> New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -ExtensionConfiguration "C:\packages\ContosoExtensionConfig.cscfg"

Cette commande crée un déploiement de production basé sur un package et une configuration. La commande spécifie une configuration d’extension nommée ContosoExtensionConfig.cscfg. Cette applet de commande crée des GUID en tant que nom et étiquette.

Paramètres

-Configuration

Spécifie le chemin complet d’un fichier de configuration de service.

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

-DoNotStart

Spécifie que cette applet de commande ne démarre pas le déploiement.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
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:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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 un nom d’étiquette pour le déploiement. Si vous ne spécifiez pas d’étiquette, cette applet de commande utilise un GUID.

Type:String
Position:4
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie un nom de déploiement. Si vous ne spécifiez pas de nom, cette applet de commande utilise un GUID.

Type:String
Alias:DeploymentName
Position:5
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Package

Spécifie le chemin d’accès ou l’URI d’un fichier .cspkg dans le stockage dans le même abonnement ou projet.

Type:String
Position:1
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

-ServiceName

Spécifie le nom du service Azure pour le déploiement.

Type:String
Position:0
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 dans lequel cette applet de commande crée le déploiement. Les valeurs valides sont les suivantes : préproduction et production. La valeur par défaut est Production.

Type:String
Position:3
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-TreatWarningsAsError

Spécifie que les messages d’avertissement sont des erreurs. Si vous spécifiez ce paramètre, un message d’avertissement provoque l’échec du déploiement.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False