Set-AzVMDscExtension
Configure l’extension DSC sur une machine virtuelle.
Syntax
Set-AzVMDscExtension
[-ResourceGroupName] <String>
[-VMName] <String>
[-Name <String>]
[-ArchiveBlobName] <String>
[-ArchiveStorageAccountName] <String>
[-ArchiveResourceGroupName <String>]
[-ArchiveStorageEndpointSuffix <String>]
[-ArchiveContainerName <String>]
[-ConfigurationName <String>]
[-ConfigurationArgument <Hashtable>]
[-ConfigurationData <String>]
[-Version] <String>
[-Force]
[-Location <String>]
[-AutoUpdate]
[-WmfVersion <String>]
[-DataCollection <String>]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Set-AzVMDscExtension configure l’extension DSC (Desired State Configuration) Windows PowerShell sur une machine virtuelle dans un groupe de ressources.
Exemples
Exemple 1 : Définir une extension DSC
Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM07" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -Version "1.10" -Location "West US"
Cette commande définit l’extension DSC sur la machine virtuelle nommée VM07 pour télécharger Sample.ps1.zip à partir du compte de stockage nommé Stg et du conteneur par défaut. La commande appelle la configuration nommée ConfigName. Le fichier Sample.ps1.zip a été précédemment chargé à l’aide de Publish-AzVMDscConfiguration.
Exemple 2 : Définir une extension DSC avec des données de configuration
Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM13" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName "WindowsPowerShellDSC" -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US"
Cette commande définit l’extension sur la machine virtuelle nommée VM13 pour télécharger Sample.ps1.zip à partir du compte de stockage nommé Stg et du conteneur nommé WindowsPowerShellDSC. Commande de la configuration nommée ConfigName et spécifie les données et arguments de configuration. Le fichier Sample.ps1.zip a été précédemment chargé à l’aide de Publish-AzVMDscConfiguration.
Exemple 3 : Définir une extension DSC avec des données de configuration qui ont une mise à jour automatique
Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM22" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName WindowsPowerShellDSC -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US" -AutoUpdate
Cette commande définit l’extension sur la machine virtuelle nommée VM22 pour télécharger Sample.ps1.zip à partir du compte de stockage nommé Stg et du conteneur nommé WindowsPowerShellDSC. La commande appelle la configuration nommée ConfigName et spécifie les données de configuration et les arguments. Cette commande active également la mise à jour automatique du gestionnaire d’extensions vers la dernière version. Le Sample.ps1.zip a été précédemment chargé à l’aide de Publish-AzVMDscConfiguration.
Paramètres
-ArchiveBlobName
Spécifie le nom du fichier de configuration précédemment chargé par l’applet de commande Publish-AzVMDscConfiguration.
Type: | String |
Aliases: | ConfigurationArchiveBlob |
Position: | 5 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveContainerName
Nom d’espèce du conteneur de stockage Azure où se trouve l’archive de configuration.
Type: | String |
Aliases: | ContainerName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveResourceGroupName
Spécifie le nom du groupe de ressources qui contient le compte de stockage qui contient l’archive de configuration. Ce paramètre est facultatif si le compte de stockage et la machine virtuelle se trouvent tous les deux dans le même groupe de ressources.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveStorageAccountName
Spécifie le nom du compte de stockage Azure utilisé pour télécharger ArchiveBlobName.
Type: | String |
Aliases: | StorageAccountName |
Position: | 4 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveStorageEndpointSuffix
Spécifie le suffixe de point de terminaison de stockage.
Type: | String |
Aliases: | StorageEndpointSuffix |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AutoUpdate
Spécifie la version du gestionnaire d’extensions spécifiée par le paramètre Version . Par défaut, le gestionnaire d’extensions n’est pas mis à jour automatiquement. Utilisez le paramètre AutoUpdate pour activer la mise à jour automatique du gestionnaire d’extensions vers la dernière version en tant que et quand elle est disponible.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigurationArgument
Spécifie une table de hachage qui contient les arguments de la fonction de configuration.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConfigurationData
Spécifie le chemin d’accès d’un fichier .psd1 qui spécifie les données de la configuration.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConfigurationName
Spécifie le nom de la configuration appelée par l’extension DSC.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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 |
-DataCollection
Spécifie le type de collecte de données. Les valeurs acceptables pour ce paramètre sont les suivantes : Activer et désactiver.
Type: | String |
Accepted values: | Enable, Disable |
Position: | Named |
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 |
-Location
Spécifie le chemin d’accès de l’extension de ressource.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Spécifie le nom de la ressource Azure Resource Manager qui représente l’extension. La valeur par défaut est Microsoft.Powershell.DSC.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoWait
Démarre l’opération et retourne immédiatement, avant la fin de l’opération. Pour déterminer si l’opération a bien été effectuée, utilisez un autre mécanisme.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Spécifie le nom du groupe de ressources de la machine virtuelle.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
Spécifie la version de l’extension DSC à laquelle Set-AzVMDscExtension applique les paramètres.
Type: | String |
Aliases: | HandlerVersion |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMName
Spécifie le nom de la machine virtuelle où le gestionnaire d’extensions DSC est installé.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
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 |
-WmfVersion
Spécifie la version WMF.
Type: | String |
Accepted values: | 4.0, 5.0, 5.1, latest |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |