Register-AzureRmAutomationDscNode

  • Referenz
Modul:
AzureRM.Automation

Registriert einen virtuellen Azure-Computer als DSC-Knoten für ein Automatisierungskonto.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

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

Beschreibung

Das Cmdlet Register-AzureRmAutomationDscNode registriert einen virtuellen Azure-Computer als APS Desired State Configuration (DSC)-Knoten in einem Azure Automation-Konto.

Beispiele

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

PS C:\>Register-AzureRmAutomationDscNode -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

Gibt den Speicherort an, an dem dieses Cmdlet einen virtuellen Computer registriert. Verwenden Sie das Cmdlet "Get-AzureRMLocation", um gültige Speicherorte abzurufen.

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

-AzureVMName

Gibt den Namen des virtuellen Azure-Computers an, den dieses Cmdlet für die Verwaltung registriert.

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

-AzureVMResourceGroup

Gibt den Namen der Ressourcengruppe des virtuellen Azure-Computers an, den dieses Cmdlet registriert.

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