Partager via


Register-AzAutomationDscNode

Inscrit une machine virtuelle Azure exécutant le système d’exploitation Windows en tant que nœud DSC pour un compte Automation.

Syntaxe

Register-AzAutomationDscNode
        -AzureVMName <String>
        [-NodeConfigurationName <String>]
        [-ConfigurationMode <String>]
        [-ConfigurationModeFrequencyMins <Int32>]
        [-RefreshFrequencyMins <Int32>]
        [-RebootNodeIfNeeded <Boolean>]
        [-ActionAfterReboot <String>]
        [-AllowModuleOverwrite <Boolean>]
        [-AzureVMResourceGroup <String>]
        [-AzureVMLocation <String>]
        [-ResourceGroupName] <String>
        [-AutomationAccountName] <String>
        [-DefaultProfile <IAzureContextContainer>]
        [<CommonParameters>]

Description

L’applet de commande Register-AzAutomationDscNode inscrit une machine virtuelle Azure en tant que nœud DSC (Desired State Configuration) APS dans un compte Azure Automation. Cette applet de commande inscrit uniquement les machines virtuelles exécutant le système d’exploitation Windows en tant que nœud DSC Automation pour un compte.

Si vous devez inscrire un nœud à un compte Automation dans un autre abonnement, vous devez utiliser un modèle ARM plutôt que des applets de commande. Pour plus d’informations, consultez la documentation Azure Automation.

Exemples

Exemple 1 : Inscrire une machine virtuelle Azure en tant que nœud Azure DSC

Register-AzAutomationDscNode -AutomationAccountName "Contoso17" -AzureVMName "VirtualMachine01" -ResourceGroupName "ResourceGroup01"-NodeConfigurationName "ContosoConfiguration.webserver"

Cette commande inscrit la machine virtuelle Azure nommée VirtualMachine01 en tant que nœud DSC dans le compte Automation nommé Contoso17.

Paramètres

-ActionAfterReboot

Spécifie l’action que la machine virtuelle prend après son redémarrage. Les valeurs valides sont :

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

-AllowModuleOverwrite

Spécifie si les nouvelles configurations téléchargées par ce nœud DSC à partir du serveur collecteur DSC Azure Automation remplacent déjà les modules existants sur le nœud cible.

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

-AutomationAccountName

Spécifie le nom d’un compte Automation dans lequel cette applet de commande inscrit une machine virtuelle.

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

-AzureVMLocation

Emplacement de la machine virtuelle Azure.

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

-AzureVMName

Nom de la machine virtuelle Azure à inscrire pour la gestion auprès d’Azure Automation DSC.

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

-AzureVMResourceGroup

Nom du groupe de ressources de machine virtuelle Azure.

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

-ConfigurationMode

Spécifie le mode de configuration DSC. Les valeurs valides sont :

  • ApplyAndMonitor
  • ApplyAndAutocorrect
  • ApplyOnly
Type:String
Valeurs acceptées:ApplyAndMonitor, ApplyAndAutocorrect, ApplyOnly
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ConfigurationModeFrequencyMins

Spécifie la fréquence, en minutes, à laquelle l’application en arrière-plan de DSC tente d’implémenter la configuration actuelle sur le nœud cible.

Type:Int32
Position:Named
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

-NodeConfigurationName

Spécifie le nom de la configuration de nœud que cette applet de commande configure la machine virtuelle pour extraire d’Azure Automation DSC.

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

-RebootNodeIfNeeded

Spécifie s’il faut redémarrer la machine virtuelle, si nécessaire.

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

-RefreshFrequencyMins

Spécifie la fréquence, en minutes, à laquelle le Gestionnaire de configuration local contacte le serveur collecteur Azure Automation DSC pour télécharger la dernière configuration de nœud.

Type:Int32
Position:Named
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 d’un groupe de ressources. Compte Automation avec lequel cette applet de commande inscrit une machine virtuelle appartient au groupe de ressources spécifié par ce paramètre.

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

Entrées

String

Int32

Boolean

Sorties

Void