Publish-AzureRmVMDscConfiguration
Charge un script DSC dans le stockage d’objets blob Azure.
Avertissement
Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.
Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntaxe
Publish-AzureRmVMDscConfiguration
[-ResourceGroupName] <String>
[-ConfigurationPath] <String>
[[-ContainerName] <String>]
[-StorageAccountName] <String>
[-StorageEndpointSuffix <String>]
[-Force]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Publish-AzureRmVMDscConfiguration
[-ConfigurationPath] <String>
[[-OutputArchivePath] <String>]
[-Force]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Publish-AzureRmVMDscConfiguration 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-AzureRmVMDscExtension.
Exemples
Exemple 1 : Créer un package .zip un chargement vers le stockage Azure
PS C:\> Publish-AzureRmVMDscConfiguration ".\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
PS C:\> Publish-AzureRmVMDscConfiguration ".\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
PS C:\> Publish-AzureRmVMDscConfiguration -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
PS C:\> Publish-AzureRmVMDscConfiguration -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
PS C:\> Publish-AzureRmVMDscConfiguration -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-AzureRmVMDscExtension
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 l’applet de commande.
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: | 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[]