Set-AzureVMDscExtension

Configure l’extension DSC sur une machine virtuelle.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

Set-AzureVMDscExtension
   [-ReferenceName <String>]
   [-ConfigurationArgument <Hashtable>]
   [-ConfigurationDataPath <String>]
   [-ConfigurationArchive] <String>
   [-ConfigurationName <String>]
   [-ContainerName <String>]
   [-Force]
   [-StorageContext <AzureStorageContext>]
   [-Version <String>]
   [-StorageEndpointSuffix <String>]
   [-WmfVersion <String>]
   [-DataCollection <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureVMDscExtension configure l’extension DSC (Desired State Configuration) sur une machine virtuelle.

Exemples

Exemple 1 : Configurer l’extension DSC sur une machine virtuelle

PS C:\> Set-AzureVMDscExtension -VM $VM -ConfigurationArchive MyConfiguration.ps1.zip  -ConfigurationName MyConfiguration -ConfigurationArgument @{ Path = 'C:\MyDirectory' }
DeploymentName              : my-vm-svc
Name                        : my-vm
Label                       :
VM                          : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVM
InstanceStatus              : ReadyRole
IpAddress                   : 10.10.10.10
InstanceStateDetails        :
PowerState                  : Started
InstanceErrorCode           :
InstanceFaultDomain         : 0
InstanceName                : my-vm
InstanceUpgradeDomain       : 0
InstanceSize                : Small
AvailabilitySetName         :
DNSName                     : http://my-vm-svc.cloudapp.net/
Status                      : ReadyRole
GuestAgentStatus            : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVMModel.GuestAgentStatus
ResourceExtensionStatusList : {Contoso.Compute.BGInfo}
PublicIPAddress             :
PublicIPName                :
ServiceName                 : my-vm-svc
OperationDescription        : Get-AzureVM
OperationId                 : a0217a7af900c1f8a212299a3333cdbd6
OperationStatus             : OK

Cette commande configure l’extension DSC sur une machine virtuelle.

Le package MyConfiguration.ps1.zip doit avoir été précédemment chargé dans le stockage Azure à l’aide de la commande Publish-AzureVMDscConfiguration et inclut le script MyConfiguration.ps1 et les modules dont il dépend.

L’argument MyConfiguration indique la configuration DSC spécifique dans le script à exécuter. Le paramètre -ConfigurationArgument spécifie une table de hachage avec les arguments passés à la fonction de configuration.

Exemple 2 : Configurer l’extension DSC sur une machine virtuelle à l’aide d’un chemin d’accès aux données de configuration

PS C:\> $VM | Set-AzureVMDscExtension -ConfigurationArchive MyConfiguration.ps1.zip  -ConfigurationName MyConfiguration -ConfigurationArgument @{ Credential = Get-Credential } -ConfigurationDataPath MyConfigurationData.psd1
DeploymentName              : my-vm-svc
Name                        : my-vm
Label                       :
VM                          : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVM
InstanceStatus              : ReadyRole
IpAddress                   : 10.10.10.10
InstanceStateDetails        :
PowerState                  : Started
InstanceErrorCode           :
InstanceFaultDomain         : 0
InstanceName                : my-vm
InstanceUpgradeDomain       : 0
InstanceSize                : Small
AvailabilitySetName         :
DNSName                     : http://my-vm-svc.cloudapp.net/
Status                      : ReadyRole
GuestAgentStatus            : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVMModel.GuestAgentStatus
ResourceExtensionStatusList : {Microsoft.Compute.BGInfo, Microsoft.Powershell.DSC}
PublicIPAddress             :
PublicIPName                :
ServiceName                 : my-vm-svc
OperationDescription        : Get-AzureVM
OperationId                 : a0217a7af900c1f8a212299a3333cdbd7
OperationStatus             : OK

Cette commande configure l’extension DSC sur une machine virtuelle à l’aide d’un chemin d’accès aux données de configuration.

Paramètres

-ConfigurationArchive

Spécifie le nom du package de configuration (fichier.zip) précédemment chargé par Publish-AzureVMDscConfiguration. Ce paramètre doit spécifier uniquement le nom du fichier, sans chemin d’accès.

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

-ConfigurationArgument

Spécifie une table de hachage spécifiant les arguments de la fonction de configuration. Les clés correspondent aux noms des paramètres et aux valeurs des paramètres.

Les valeurs valides pour ce paramètre sont :

  • types primitifs
  • string
  • tableau
  • PSCredential
Type:Hashtable
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 fonction de configuration. Ce fichier doit contenir une table de hachage, comme décrit dans La séparation des données de configuration et d’environnementhttps://msdn.microsoft.com/en-us/PowerShell/DSC/configData.

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

-ConfigurationName

Spécifie le nom du script de configuration ou du module appelé par l’extension DSC.

La valeur de ce paramètre doit être le nom de l’une des fonctions de configuration contenues dans les scripts ou modules empaquetés dans ConfigurationArchive.

Cette applet de commande prend par défaut le nom du fichier donné par le paramètre ConfigurationArchive si vous omettez ce paramètre, à l’exclusion de toute extension. Par exemple, si ConfigurationArchive est « SalesWebSite.ps1.zip », la valeur par défaut de ConfigurationName est « SalesWebSite ».

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

-ContainerName

Spécifie le nom du conteneur de stockage Azure où se trouve ConfigurationArchive .

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

-DataCollection

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

-Force

Indique que cette applet de commande remplace les objets blob existants.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
  • Renseignez-vous
  • SilentlyContinue
  • Arrêter
  • Suspendre
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Spécifie une variable d’informations.

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

-ReferenceName

Spécifie une chaîne définie par l’utilisateur qui peut être utilisée pour faire référence à une extension. Ce paramètre est spécifié lorsque l’extension est ajoutée à la machine virtuelle pour la première fois. Pour les mises à jour suivantes, vous devez spécifier le nom de référence précédemment utilisé lors de la mise à jour de l’extension. Le ReferenceName affecté à une extension est retourné à l’aide de l’applet de commande Get-AzureVM .

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

-StorageContext

Spécifie le contexte de stockage Azure qui fournit les paramètres de sécurité utilisés pour accéder au script de configuration. Ce contexte fournit un accès en lecture au conteneur spécifié par le paramètre ContainerName .

Type:AzureStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageEndpointSuffix

Spécifie le suffixe de point de terminaison DNS pour tous les services de stockage, par exemple « core.contoso.net ».

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

-Version

Spécifie la version spécifique de l’extension DSC à utiliser. La valeur par défaut est définie sur « 1.* » si ce paramètre n’est pas spécifié.

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

-VM

Spécifie l’objet de machine virtuelle persistante.

Type:IPersistentVM
Aliases:InputObject
Position:Named
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 du Windows Management Framework (WMF) à installer sur la machine virtuelle. L’extension DSC dépend des fonctionnalités DSC disponibles uniquement dans les mises à jour WMF. Ce paramètre spécifie la version de la mise à jour à installer sur la machine virtuelle. Les valeurs valides pour ce paramètre sont :

  • 4.0. Installe WMF 4.0, sauf si une version plus récente est déjà installée.
  • 5.0. Installe la dernière version de WMF 5.0.
  • Dernière. Installe la dernière version de WMF, actuellement WMF 5.0.

La valeur par défaut est latest.

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