Publish-AzVMDscConfiguration

  • Référence
Module:
Az.Compute

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

Syntax

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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContainerName

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

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:ConfigurationArchivePath
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SkipDependencyDetection

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageEndpointSuffix

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

String[]

Sorties

String