New-AzAutomationSoftwareUpdateConfiguration

Referência

Módulo:: Az.Automation

Cria uma configuração de atualização de software de automação do azure agendada.

Syntax

New-AzAutomationSoftwareUpdateConfiguration
   -Schedule <Schedule>
   [-Windows]
   [-RebootOnly]
   [-AzureVMResourceId <String[]>]
   [-PreTaskRunbookName <String>]
   [-PostTaskRunbookName <String>]
   [-PreTaskRunbookParameter <Hashtable>]
   [-PostTaskRunbookParameter <Hashtable>]
   [-NonAzureComputer <String[]>]
   [-AzureQuery <AzureQueryProperties[]>]
   [-NonAzureQuery <NonAzureQueryProperties[]>]
   [-Duration <TimeSpan>]
   [-RebootSetting <RebootSetting>]
   [-IncludedUpdateClassification <WindowsUpdateClasses[]>]
   [-ExcludedKbNumber <String[]>]
   [-IncludedKbNumber <String[]>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzAutomationSoftwareUpdateConfiguration
   -Schedule <Schedule>
   [-Linux]
   [-RebootOnly]
   [-AzureVMResourceId <String[]>]
   [-PreTaskRunbookName <String>]
   [-PostTaskRunbookName <String>]
   [-PreTaskRunbookParameter <Hashtable>]
   [-PostTaskRunbookParameter <Hashtable>]
   [-NonAzureComputer <String[]>]
   [-AzureQuery <AzureQueryProperties[]>]
   [-NonAzureQuery <NonAzureQueryProperties[]>]
   [-Duration <TimeSpan>]
   [-RebootSetting <RebootSetting>]
   [-IncludedPackageClassification <LinuxPackageClasses[]>]
   [-ExcludedPackageNameMask <String[]>]
   [-IncludedPackageNameMask <String[]>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cria uma configuração de atualização de software que é executada em um cronograma para atualizar uma lista de computadores. Os computadores incluem máquinas virtuais azure ou computadores não-az.

Exemplos

Exemplo 1

Cria uma configuração de atualização de software para instalar atualizações críticas em duas máquinas virtuais do Windows azure uma vez a cada sábado, às 21h. A duração da atualização é definida como 2 horas neste exemplo.

$startTime = [DateTimeOffset]"2018-09-13T21:00"
$targetMachines = @(
    "/subscriptions/22e2445a-0984-4fa5-86a4-0280d76c4b2c/resourceGroups/compute/providers/Microsoft.Compute/virtualMachines/vm-w-01",
    "/subscriptions/22e2445a-0984-4fa5-86a4-0280d76c4b2c/resourceGroups/compute/providers/Microsoft.Compute/virtualMachines/vm-w-02"
)
$duration = New-TimeSpan -Hours 2
$schedule = New-AzAutomationSchedule -ResourceGroupName "mygroup" `
                                                  -AutomationAccountName "myaccount" `
                                                  -Name MyWeeklySchedule `
                                                  -StartTime $startTime `
                                                  -DaysOfWeek Saturday `
                                                  -WeekInterval 1 `
                                                  -ForUpdateConfiguration

New-AzAutomationSoftwareUpdateConfiguration -ResourceGroupName "mygroup" `
                                                 -AutomationAccountName "myaccount" `
                                                 -Schedule $schedule `
                                                 -Windows `
                                                 -AzureVMResourceId $targetMachines `
                                                 -IncludedUpdateClassification Critical `
                                                 -Duration $duration

UpdateConfiguration   : Microsoft.Azure.Commands.Automation.Model.UpdateManagement.UpdateConfiguration
ScheduleConfiguration : Microsoft.Azure.Commands.Automation.Model.Schedule
ProvisioningState     : Provisioning
ErrorInfo             :
ResourceGroupName     : mygroup
AutomationAccountName : myaccount
Name                  : MyWeeklySchedule
CreationTime          : 9/14/2018 3:53:27 AM +00:00
LastModifiedTime      : 9/14/2018 3:53:27 AM +00:00
Description           :

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

-AzureQuery

Consulta azure do grupo dinâmico.

Type:	AzureQueryProperties[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-AzureVMResourceId

Ids de recursos para máquinas virtuais do Azure.

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para 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

-Duration

Duração máxima da atualização.

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

-ExcludedKbNumber

Números de KB de atualizações excluídas.

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

-ExcludedPackageNameMask

Máscaras de pacotes Linux excluídas.

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

-IncludedKbNumber

Números KB de atualizações incluídas.

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

-IncludedPackageClassification

Classificações de pacotes Linux incluídas.

Type:	LinuxPackageClasses[]
Accepted values:	Unclassified, Critical, Security, Other
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IncludedPackageNameMask

Máscaras de pacote Linux incluídas.

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

-IncludedUpdateClassification

Classificações incluídas do Windows Update.

Type:	WindowsUpdateClasses[]
Accepted values:	Unclassified, Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Linux

Indica que a configuração de atualização de software destinada a máquinas do sistema operacional Linux.

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

-NonAzureComputer

Nomes de computadores não-Az.

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

-NonAzureQuery

Grupo dinâmico que não é consulta do Azure.

Type:	NonAzureQueryProperties[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PostTaskRunbookName

Tarefa de postagem.

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

-PostTaskRunbookParameter

Parâmetro de tarefa Post.

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

-PreTaskRunbookName

Pré tarefa.

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

-PreTaskRunbookParameter

Parâmetro de pré-tarefa.

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

-RebootOnly

Indica que a configuração de atualização de software só reinicializará as máquinas.

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

-RebootSetting

Configuração de reinicialização.

Type:	RebootSetting
Accepted values:	IfRequired, Never, Always, RebootOnly
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

-Schedule

Objeto de agendamento usado para configuração de atualização de software.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Windows

Indica que a configuração de atualização de software direcionada a máquinas do sistema operacional Windows.

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

Entradas

Schedule

SwitchParameter

String[]

TimeSpan

WindowsUpdateClasses[]

LinuxPackageClasses[]

String

Saídas

SoftwareUpdateConfiguration