Freigeben über


Get-AzureRmAutomationSoftwareUpdateRun

Ruft eine Liste der Azure-Automatisierungssoftwareupdates 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-AzureRmAutomationSoftwareUpdateRun
   [-OperatingSystem <OperatingSystemType>]
   [-Status <SoftwareUpdateRunStatus>]
   [-StartTime <DateTimeOffset>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationSoftwareUpdateRun
   -Id <Guid>
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationSoftwareUpdateRun
   [-SoftwareUpdateConfigurationName <String>]
   [-OperatingSystem <OperatingSystemType>]
   [-Status <SoftwareUpdateRunStatus>]
   [-StartTime <DateTimeOffset>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationSoftwareUpdateRun
   [-SoftwareUpdateConfiguration <SoftwareUpdateConfiguration>]
   [-OperatingSystem <OperatingSystemType>]
   [-Status <SoftwareUpdateRunStatus>]
   [-StartTime <DateTimeOffset>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-AzureRmAutomationSoftwareUpdateRun gibt eine Liste der Softwareupdateausführungen zurück. Da eine Softwareupdatekonfiguration über einen zugeordneten Zeitplan verfügt, kann sie mehrmals ausgelöst werden. Jedes Mal, wenn ein Zeitplan ausgelöst wird, führt zu einer erstellten Aktualisierungsausführung. Die Updateausführung ist ein Aggregat des Ergebnisses aller Computerausführungen. Sie können Ausführungen für bestimmte Softwareupdatekonfigurationen abrufen, indem Sie den Parameter "SoftwareUpdateConfigurationName" übergeben. Um eine bestimmte Ausführung abzurufen, müssen Sie den Namensparameter übergeben. Sie können auch Ausführungen mit einem bestimmten Status auflisten, für bestimmte Operatins-Systeme bestimmt sein oder nach bestimmten Zeiten gestartet werden, indem Sie den entsprechenden Parameter übergeben.

Beispiele

Beispiel 1

In diesem Beispiel werden alle Updateausführungen aufgeführt, die durch eine bestimmte Softwareupdatekonfiguration ausgelöst werden.

PS C:\> Get-AzureRmAutomationSoftwareUpdateRun -ResourceGroupName "mygroup" `
                                               -AutomationAccountName "myaccount" `
                                               -SoftwareUpdateConfigurationName "MyUpdateConfiguration"

RunId                           : ec9ce57f-da18-44be-b33b-651a0f93cb52
SoftwareUpdateConfigurationName : MyUpdateConfiguration
ConfiguredDuration              : 02:00:00
OperatingSystem                 : Windows
StartTime                       : 5/22/2018 11:37:42 PM +00:00
EndTime                         : 5/22/2018 11:38:31 PM +00:00
ComputerCount                   : 2
FailedCount                     : 0
ResourceGroupName               : mygroup
AutomationAccountName           : myaccount
Name                            : ec9ce57f-da18-44be-b33b-651a0f93cb52
CreationTime                    : 5/22/2018 11:37:42 PM +00:00
LastModifiedTime                : 5/22/2018 11:38:54 PM +00:00
Description                     :

RunId                           : ac9396c7-a837-43d4-be97-fbfe46c80baa
SoftwareUpdateConfigurationName : MyUpdateConfiguration
ConfiguredDuration              : 02:00:00
OperatingSystem                 : Windows
StartTime                       : 5/22/2018 10:00:47 PM +00:00
EndTime                         : 5/22/2018 10:02:20 PM +00:00
ComputerCount                   : 2
FailedCount                     : 0
ResourceGroupName               : mygroup
AutomationAccountName           : myaccount
Name                            : ac9396c7-a837-43d4-be97-fbfe46c80baa
CreationTime                    : 5/22/2018 10:00:47 PM +00:00
LastModifiedTime                : 5/22/2018 10:02:58 PM +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

Die ID der Softwareupdatekonfiguration wird ausgeführt.

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

-OperatingSystem

Das Betriebssystem der Ausführung.

Typ:Nullable<T>[OperatingSystemType]
Zulässige Werte:Windows, Linux
Position:Named
Standardwert:None
Erforderlich:False
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

-SoftwareUpdateConfiguration

Die Softwareupdatekonfiguration hat die Ausführung ausgelöst.

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

-SoftwareUpdateConfigurationName

Der Name der Softwareupdatekonfiguration hat die Ausführung ausgelöst.

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

-StartTime

Minimale Startzeit der Ausführung.

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

-Status

Status der Ausführung

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

Eingaben

Guid

String

SoftwareUpdateConfiguration

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

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

DateTimeOffset

Ausgaben

SoftwareUpdateRun