Freigeben über


Register-AzAutomationDscNode

Registriert einen virtuellen Azure-Computer, auf dem Windows OS als DSC-Knoten für ein Automatisierungskonto ausgeführt wird.

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>]

Beschreibung

Das Cmdlet Register-AzAutomationDscNode registriert einen virtuellen Azure-Computer als APS Desired State Configuration (DSC)-Knoten in einem Azure Automation-Konto. Dieses Cmdlet registriert nur VMs, auf denen Windows-Betriebssystem ausgeführt wird, als Automatisierungs-DSC-Knoten für ein Konto.

Wenn Sie einen Knoten für ein Automatisierungskonto in einem anderen Abonnement registrieren müssen, müssen Sie eine ARM-Vorlage anstelle von Cmdlets verwenden. Weitere Details finden Sie in der Azure Automation-Dokumentation.

Beispiele

Beispiel 1: Registrieren eines virtuellen Azure-Computers als Azure DSC-Knoten

Register-AzAutomationDscNode -AutomationAccountName "Contoso17" -AzureVMName "VirtualMachine01" -ResourceGroupName "ResourceGroup01"-NodeConfigurationName "ContosoConfiguration.webserver"

Mit diesem Befehl wird der virtuelle Azure-Computer "VirtualMachine01" als DSC-Knoten im Automatisierungskonto namens Contoso17 registriert.

Parameter

-ActionAfterReboot

Gibt die Aktion an, die der virtuelle Computer nach dem Neustart ausführt. Gültige Werte sind:

  • ContinueConfiguration
  • StopConfiguration
Typ:String
Zulässige Werte:ContinueConfiguration, StopConfiguration
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-AllowModuleOverwrite

Gibt an, ob neue Konfigurationen, die dieser DSC-Knoten vom Azure Automation DSC-Pullserver herunterlädt, die vorhandenen Module ersetzen, die sich bereits auf dem Zielknoten befinden.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-AutomationAccountName

Gibt den Namen eines Automatisierungskontos an, in dem dieses Cmdlet einen virtuellen Computer registriert.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-AzureVMLocation

Der Speicherort des virtuellen Azure-Computers.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-AzureVMName

Der Name des virtuellen Azure-Computers, der für die Verwaltung bei Azure Automation DSC registriert werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-AzureVMResourceGroup

Der Name der Azure VM-Ressourcengruppe.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ConfigurationMode

Gibt den DSC-Konfigurationsmodus an. Gültige Werte sind:

  • ApplyAndMonitor
  • ApplyAndAutocorrect
  • ApplyOnly
Typ:String
Zulässige Werte:ApplyAndMonitor, ApplyAndAutocorrect, ApplyOnly
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ConfigurationModeFrequencyMins

Gibt die Häufigkeit in Minuten an, mit der die Hintergrundanwendung von DSC versucht, die aktuelle Konfiguration auf dem Zielknoten zu implementieren.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NodeConfigurationName

Gibt den Namen der Knotenkonfiguration an, die dieses Cmdlet konfiguriert, um den virtuellen Computer aus Azure Automation DSC abzurufen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RebootNodeIfNeeded

Gibt an, ob der virtuelle Computer bei Bedarf neu gestartet werden soll.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RefreshFrequencyMins

Gibt die Häufigkeit in Minuten an, mit der der lokale Configuration Manager den Azure Automation DSC-Pullserver kontaktiert, um die neueste Knotenkonfiguration herunterzuladen.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt den Namen einer Ressourcengruppe an. Das Automatisierungskonto, mit dem dieses Cmdlet einen virtuellen Computer registriert, gehört zur Ressourcengruppe, die dieser Parameter angibt.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

Int32

Boolean

Ausgaben

Void