Get-AzureRmAutomationSoftwareUpdateMachineRun

Ruft eine Liste der Azure Automation Software Update Configuration Machine ausgeführt wird.

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 weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Get-AzureRmAutomationSoftwareUpdateMachineRun
   [-Status <SoftwareUpdateMachineRunStatus>]
   [-TargetComputer <String>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationSoftwareUpdateMachineRun
   -Id <Guid>
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationSoftwareUpdateMachineRun
   [-SoftwareUpdateRunId <Guid>]
   [-Status <SoftwareUpdateMachineRunStatus>]
   [-TargetComputer <String>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationSoftwareUpdateMachineRun
   [-SoftwareUpdateRun <SoftwareUpdateRun>]
   [-Status <SoftwareUpdateMachineRunStatus>]
   [-TargetComputer <String>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Dieses Cmdlet gibt eine Liste der Computerausführungen zurück. Jede Softwareupdateausführung löst einen Computer aus, der für jeden Konfigurationszielcomputer für Softwareupdates ausgeführt wird. Um eine bestimmte Computerausführung abzurufen, übergeben Sie den ID-Parameter. Sie können alle Computerausführungen auflisten, alle für einen bestimmten Computer ausgeführt werden, alle werden mit einem bestimmten Status ausgeführt, indem Sie die entsprechenden Parameter übergeben.

Beispiele

Beispiel 1

In diesem Beispiel werden alle fehlgeschlagenen Computerausführungen für den angegebenen virtuellen Azure-Computer zurückgegeben.

PS C:\> $targetComputer = "/subscriptions/22e2445a-0984-4fa5-86a4-0280d76c4b2c/resourceGroups/compute/providers/Microsoft.Compute/virtualMachines/myvm"
PS C:\> Get-AzureRmAutomationSoftwareUpdateMachineRun -ResourceGroupName "mygroup" `
                                                      -AutomationAccountName "myaccount" `
                                                      -TargetComputer $targetComputer `
                                                      -Status Failed

MachineRunId          : 0033d6d6-828d-4712-adab-293cc4fc8809
TargetComputer        : /subscriptions/22e2445a-0984-4fa5-86a4-0280d76c4b2c/resourceGroups/compute/providers/Microsoft.Compute/virtualMachines/myvm
TargetComputerType    : AzureVirtualMachines
SoftwareUpdateRunId   : 46568d26-0182-49b2-8bfd-af3455780397
OperatingSystem       : Windows
Status                : Failed
ResourceGroupName     : mygroup
AutomationAccountName : myaccount
Name                  : 0033d6d6-828d-4712-adab-293cc4fc8809
CreationTime          : 5/17/2018 2:06:44 AM +00:00
LastModifiedTime      : 5/17/2018 2:08:49 AM +00:00

Parameter

-AutomationAccountName

Der Name des Automatisierungskontos.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
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

-Id

ID des Ausgeführten Softwareupdatecomputers.

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

-ResourceGroupName

Der Name der Ressourcengruppe.

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

-SoftwareUpdateRun

Das Softwareupdate wird ausgeführt.

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

-SoftwareUpdateRunId

ID der Softwareupdateausführung.

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

-Status

Der Status des Computers wird ausgeführt.

Typ:Nullable<T>[SoftwareUpdateMachineRunStatus]
Zulässige Werte:NotStarted, InProgress, Succeeded, Failed, MaintenanceWindowExceeded, FailedToStart
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TargetComputer

Zielcomputer für die Computerausführung. Kann entweder ein Name eines Nicht-Azure-Computers oder eine Azure VM-Ressourcen-ID sein.

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

Eingaben

Guid

SoftwareUpdateRun

Nullable<T>[[Microsoft.Azure.Commands.Automation.Model.UpdateManagement.SoftwareUpdateMachineRunStatus, Microsoft.Azure.Commands.ResourceManager.Automation, Version=5.1.1.0, Culture=neutral, PublicKeyToken=null]]

String

Ausgaben

SoftwareUpdateMachineRun