Share via


Get-AzAutomationSoftwareUpdateRun

Obtém uma lista de execuções de atualização de software de automação do Azure.

Syntax

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>]

Description

O cmdlet Get-AzAutomationSoftwareUpdateRun retorna uma lista de execuções de atualização de software. Como uma configuração de atualização de software tem uma agenda associada, ela pode ser acionada várias vezes. Cada vez que uma agenda é acionada resultará em uma execução de atualização criada. A execução de atualização é uma agregação do resultado de todas as execuções de máquina. Você pode obter execuções para configuração de atualização de software específica passando o parâmetro SoftwareUpdateConfigurationName. Para obter execuções específicas, você precisa passar o parâmetro name. Você também pode listar execuções com status específico, execuções direcionadas a um sistema operacional específico ou execuções iniciadas após um tempo específico, passando o parâmetro apropriado.

Exemplos

Exemplo 1

Este exemplo lista todas as execuções de atualização acionadas por uma configuração de atualização de software específica.

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

Parâmetros

-AutomationAccountName

O nome da conta de automação.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

ID da configuração de atualização de software executada.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-OperatingSystem

O sistema operacional da execução.

Type:Nullable<T>[OperatingSystemType]
Accepted values:Windows, Linux
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

O nome do grupo de recursos.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SoftwareUpdateConfiguration

A configuração de atualização de software acionou a execução.

Type:SoftwareUpdateConfiguration
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SoftwareUpdateConfigurationName

Nome da configuração de atualização de software disparou a execução.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StartTime

Hora mínima de início da corrida.

Type:DateTimeOffset
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Status

Status da execução.

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

Entradas

Guid

String

SoftwareUpdateConfiguration

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]]

DateTimeOffset

Saídas

SoftwareUpdateRun