Partager via


Register-AzureRmAutomationDscNode

Inscrit une machine virtuelle Azure en tant que nœud DSC pour un compte Automation.

Avertissement

Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntax

Register-AzureRmAutomationDscNode
        -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-AzureRmAutomationDscNode inscrit une machine virtuelle Azure en tant que nœud APS Desired State Configuration (DSC) dans un compte Azure Automation.

Exemples

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

PS C:\>Register-AzureRmAutomationDscNode -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
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False

-AzureVMLocation

Spécifie l’emplacement dans lequel cette applet de commande inscrit une machine virtuelle. Pour obtenir des emplacements valides, utilisez l’applet de commande Get-AzureRMLocation.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureVMName

Spécifie le nom de la machine virtuelle Azure que cette applet de commande inscrit pour la gestion.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-AzureVMResourceGroup

Spécifie le nom du groupe de ressources de la machine virtuelle Azure que cette applet de commande inscrit.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False

Entrées

String

Int32

Boolean

Sorties

Void