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

Default (Par défaut)

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 les suivantes :

  • ContinueConfiguration
  • StopConfiguration

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:ContinueConfiguration, StopConfiguration
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-AutomationAccountName

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-AzureVMLocation

Emplacement de la machine virtuelle Azure.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-AzureVMName

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-AzureVMResourceGroup

Nom du groupe de ressources de machine virtuelle Azure.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ConfigurationMode

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

  • ApplyAndMonitor
  • ApplyAndAutocorrect
  • ApplyOnly

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:ApplyAndMonitor, ApplyAndAutocorrect, ApplyOnly
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-RebootNodeIfNeeded

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

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Int32

Boolean

Sorties

Void