Get-AzAutomationSoftwareUpdateRun
Gets a list of azure automation software update runs.
Get-AzAutomationSoftwareUpdateRun
[-OperatingSystem <OperatingSystemType>]
[-Status <SoftwareUpdateRunStatus>]
[-StartTime <DateTimeOffset>]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzAutomationSoftwareUpdateRun
-Id <Guid>
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzAutomationSoftwareUpdateRun
[-SoftwareUpdateConfigurationName <String>]
[-OperatingSystem <OperatingSystemType>]
[-Status <SoftwareUpdateRunStatus>]
[-StartTime <DateTimeOffset>]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzAutomationSoftwareUpdateRun
[-SoftwareUpdateConfiguration <SoftwareUpdateConfiguration>]
[-OperatingSystem <OperatingSystemType>]
[-Status <SoftwareUpdateRunStatus>]
[-StartTime <DateTimeOffset>]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
The Get-AzAutomationSoftwareUpdateRun cmdlet returns a list of software update runs. Since a software update configuration has an associated schedule, it can be triggered multiple times. Each time a schedule is triggered will result in an update run created. Update run is an aggregate of the result of all machine runs. You can get runs for specific software update configuration by passing the SoftwareUpdateConfigurationName parameter. To get a specific runs, you need to pass the name parameter. You can also list runs with specific status, runs targeting specific operating system, or runs started after specific time by passing the appropriate parameter.
This example list all update runs triggered by a specific software update configuration.
Get-AzAutomationSoftwareUpdateRun -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
The automation account name.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
The credentials, account, tenant, and subscription used for communication with Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Id of the software update configuration run.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
The operating system of the run.
Type: | Nullable<T>[OperatingSystemType] |
Accepted values: | Windows, Linux |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
The resource group name.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
The software update configuration triggered the run.
Type: | SoftwareUpdateConfiguration |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Name of the software update configuration triggered the run.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Minimum start time of the run.
Type: | DateTimeOffset |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Status of the run.
Type: | Nullable<T>[SoftwareUpdateRunStatus] |
Accepted values: | NotStarted, InProgress, Succeeded, Failed, MaintenanceWindowExceeded |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Nullable<T>[[Microsoft.Azure.Commands.Automation.Model.UpdateManagement.OperatingSystemType, Microsoft.Azure.PowerShell.Cmdlets.Automation, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
Nullable<T>[[Microsoft.Azure.Commands.Automation.Model.UpdateManagement.SoftwareUpdateRunStatus, Microsoft.Azure.PowerShell.Cmdlets.Automation, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
Azure PowerShell feedback
Azure PowerShell is an open source project. Select a link to provide feedback: