Freigeben über

Get-AzureRmAutomationDscNode

  • Referenz
Modul:
AzureRM.Automation

Ruft DSC-Knoten aus der Automatisierung ab.

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

Get-AzureRmAutomationDscNode
   [-Status <DscNodeStatus>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationDscNode
   -Id <Guid>
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationDscNode
   [-Status <DscNodeStatus>]
   -Name <String>
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationDscNode
   [-Status <DscNodeStatus>]
   -NodeConfigurationName <String>
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationDscNode
   -ConfigurationName <String>
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-AzureRmAutomationDscNode ruft APS Desired State Configuration (DSC)-Knoten aus Azure Automation ab.

Beispiele

Beispiel 1: Abrufen aller DSC-Knoten

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17"

Dieser Befehl ruft Metadaten für alle DSC-Knoten im Automatisierungskonto namens Contoso17 ab.

Beispiel 2: Abrufen aller DSC-Knoten für eine DSC-Konfiguration

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -ConfigurationName "ContosoConfiguration"

Dieser Befehl ruft Metadaten für alle DSC-Knoten im Automatisierungskonto namens Contoso17 ab, die einer DSC-Knotenkonfiguration zugeordnet sind, die von der DSC-Konfiguration ContosoConfiguration generiert wurde.

Beispiel 3: Abrufen eines DSC-Knotens nach ID

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -Id c0a1718e-d8be-4fa3-91b6-82e1d3a36298

Dieser Befehl ruft Metadaten auf einem DSC-Knoten mit der angegebenen ID im Automatisierungskonto namens Contoso17 ab.

Beispiel 4: Abrufen eines DSC-Knotens anhand des Namens

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -Name "Computer14"

Dieser Befehl ruft Metadaten auf einem DSC-Knoten mit dem Namen Computer14 im Automatisierungskonto namens Contoso17 ab.

Beispiel 5: Abrufen aller DSC-Knoten, die einer DSC-Knotenkonfiguration zugeordnet sind

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -NodeConfigurationName "ContosoConfiguration.webserver"

Dieser Befehl ruft Metadaten auf allen DSC-Knoten im Automatisierungskonto namens Contoso17 ab, die einer DSC-Knotenkonfiguration namens ContosoConfiguration.webserver zugeordnet sind.

Parameter

-AutomationAccountName

Gibt den Namen des Automatisierungskontos an, das die DSC-Knoten enthält, die dieses Cmdlet abruft.

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

-ConfigurationName

Gibt den Namen einer DSC-Konfiguration an. Dieses Cmdlet ruft DSC-Knoten ab, die mit den Knotenkonfigurationen übereinstimmen, die aus der Konfiguration generiert werden, die dieser Parameter angibt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
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

-Id

Gibt die eindeutige ID des DSC-Knotens an, den dieses Cmdlet abruft.

Typ:Guid
Aliase:NodeId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines DSC-Knotens an, den dieses Cmdlet abruft.

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

-NodeConfigurationName

Gibt den Namen einer Knotenkonfiguration an, die dieses Cmdlet abruft.

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

-ResourceGroupName

Gibt den Namen einer Ressourcengruppe an, in der dieses Cmdlet DSC-Knoten abruft.

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

-Status

Gibt den Status der DSC-Knoten an, die dieses Cmdlet abruft. Gültige Werte sind:

  • Konform
  • NotCompliant
  • Fehler
  • Ausstehend
  • Empfangen
  • Keine Reaktion
Typ:DscNodeStatus
Zulässige Werte:Compliant, NotCompliant, Failed, Pending, Received, Unresponsive
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Guid

String

Ausgaben

DscNode