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 |