Partager via

Publish-AzVMDscConfiguration

  • Référence
Module:
Az.Compute

Charge un script DSC dans le stockage d’objets blob Azure.

Syntaxe

Publish-AzVMDscConfiguration
       [-ResourceGroupName] <String>
       [-ConfigurationPath] <String>
       [[-ContainerName] <String>]
       [-StorageAccountName] <String>
       [-StorageEndpointSuffix <String>]
       [-Force]
       [-SkipDependencyDetection]
       [-ConfigurationDataPath <String>]
       [-AdditionalPath <String[]>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-AzVMDscConfiguration
       [-ConfigurationPath] <String>
       [[-OutputArchivePath] <String>]
       [-Force]
       [-SkipDependencyDetection]
       [-ConfigurationDataPath <String>]
       [-AdditionalPath <String[]>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

L’applet de commande Publish-AzVMDscConfiguration charge un script DSC (Desired State Configuration) dans le stockage d’objets blob Azure, qui peut ensuite être appliqué aux machines virtuelles Azure à l’aide de l’applet de commande Set-AzVMDscExtension.

Exemples

Exemple 1 : Créer un package .zip un chargement vers le stockage Azure

Publish-AzVMDscConfiguration ".\MyConfiguration.ps1"

Cette commande crée un package .zip pour le script donné et tous les modules de ressources dépendants et le charge dans le stockage Azure.

Exemple 2 : Créer un package .zip et le stocker dans un fichier local

Publish-AzVMDscConfiguration ".\MyConfiguration.ps1" -OutputArchivePath ".\MyConfiguration.ps1.zip"

Cette commande crée un package .zip pour le script donné et tous les modules de ressources dépendants et les stocke dans le fichier local nommé .\MyConfiguration.ps1.zip.

Exemple 3 : Ajouter une configuration à l’archive, puis la charger dans le stockage

Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -SkipDependencyDetection

Cette commande ajoute la configuration nommée Sample.ps1 à l’archive de configuration à charger dans le stockage Azure et ignore les modules de ressources dépendants.

Exemple 4 : Ajouter des données de configuration et de configuration à l’archive, puis les charger dans le stockage

Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -ConfigurationDataPath "C:\SampleData.psd1"

Cette commande ajoute la configuration nommée Sample.ps1 et les données de configuration nommées SampleData.psd1 à l’archive de configuration à charger dans le stockage Azure.

Exemple 5 : Ajouter une configuration, des données de configuration et du contenu supplémentaire à l’archive, puis le charger dans le stockage

Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -AdditionalPath @("C:\ContentDir1", "C:\File.txt") -ConfigurationDataPath "C:\SampleData.psd1"

Cette commande ajoute la configuration nommée Sample.ps1, les données de configuration SampleData.psd1 et le contenu supplémentaire à l’archive de configuration à charger dans le stockage Azure.

Paramètres

-AdditionalPath

Spécifie le chemin d’accès d’un fichier ou d’un répertoire à inclure dans l’archive de configuration. Il est téléchargé sur la machine virtuelle avec la configuration.

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

-ConfigurationDataPath

Spécifie le chemin d’accès d’un fichier .psd1 qui spécifie les données de la configuration. Cette opération est ajoutée à l’archive de configuration, puis transmise à la fonction de configuration. Il est remplacé par le chemin des données de configuration fourni via l’applet de commande Set-AzVMDscExtension

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

-ConfigurationPath

Spécifie le chemin d’accès d’un fichier qui contient une ou plusieurs configurations. Le fichier peut être un fichier de script Windows PowerShell (.ps1) ou un fichier de module Windows PowerShell (.psm1).

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

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

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

-ContainerName

Spécifie le nom du conteneur de stockage Azure vers lequel la configuration est chargée.

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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-OutputArchivePath

Spécifie le chemin d’accès d’un fichier .zip local dans lequel écrire l’archive de configuration. Lorsque ce paramètre est utilisé, le script de configuration n’est pas chargé dans le stockage Blob Azure.

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

-ResourceGroupName

Spécifie le nom du groupe de ressources qui contient le compte de stockage.

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

-SkipDependencyDetection

Indique que cette applet de commande exclut les dépendances de ressources DSC de l’archive de configuration.

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

-StorageAccountName

Spécifie le nom du compte de stockage Azure utilisé pour charger le script de configuration dans le conteneur spécifié par le paramètre ContainerName .

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

-StorageEndpointSuffix

Spécifie le suffixe du point de terminaison de stockage.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

String

String[]

Sorties

String