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 |