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 .
Sorties