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.

Syntax

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
Accepted values:ContinueConfiguration, StopConfiguration
Position:Named
Default value:None
Required: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
Default value:None
Required: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-AzureVMLocation

Emplacement de la machine virtuelle Azure.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureVMName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-AzureVMResourceGroup

Nom du groupe de ressources de machine virtuelle Azure.

Type:String
Position:Named
Default value:None
Required: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
Accepted values:ApplyAndMonitor, ApplyAndAutocorrect, ApplyOnly
Position:Named
Default value:None
Required: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
Default value:None
Required: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:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required: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
Default value:None
Required: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
Default value:None
Required: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
Default value:None
Required: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

String

Int32

Boolean

Sorties

Void