New-CMOperatingSystemImageUpdateSchedule

Módulo:

ConfigurationManager

Cria uma agenda de atualização de imagens do sistema operativo.

Sintaxe

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-CustomSchedule <DateTime>]
   -InputObject <IResultObject>
   [-RemoveSupersededUpdates <Boolean>]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-Utc <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-CustomSchedule <DateTime>]
   [-RemoveSupersededUpdates <Boolean>]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-Utc <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-CustomSchedule <DateTime>]
   [-RemoveSupersededUpdates <Boolean>]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-Utc <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-CustomSchedule <DateTime>]
   [-RemoveSupersededUpdates <Boolean>]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-Utc <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   -Id <String>
   [-RemoveSupersededUpdates <Boolean>]
   [-RunNow]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   -InputObject <IResultObject>
   [-RemoveSupersededUpdates <Boolean>]
   [-RunNow]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   -Name <String>
   [-RemoveSupersededUpdates <Boolean>]
   [-RunNow]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMOperatingSystemImageUpdateSchedule
   [-ContinueOnError <Boolean>]
   [-RemoveSupersededUpdates <Boolean>]
   [-RunNow]
   -SoftwareUpdate <IResultObject[]>
   [-UpdateDistributionPoint <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-CMOperatingSystemImageUpdateSchedule cria uma agenda de atualização da imagem do sistema operativo.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Criar uma agenda de atualização de imagens do sistema operativo

PS ABC:\> $Win10Image = Get-CMOperatingSystemImage -Name "Windows 10 Enterprise"
PS ABC:\> $Win10SU = Get-CMSoftwareUpdate -UpdateGroupName "Win10SUgroup01"
PS ABC:\> New-CMOperatingSystemImageUpdateSchedule -Name $Win10Image.Name -SoftwareUpdate $Win10SU -RunNow -ContinueOnError $True

O primeiro comando obtém o objeto de imagem do sistema operativo com o nome Windows 10 Enterprise e armazena o objeto na variável $Win 10Image.

O segundo comando obtém o objeto de atualização de software para o grupo de atualizações com o nome Win10SUgroup01 e armazena o objeto na variável $Win 10SU.

O último comando cria uma agenda de atualização da imagem do sistema operativo para atualizar a imagem do sistema operativo com o nome Windows 10 Enterprise com a atualização armazenada no $Win 10SU. A atualização será executada agora e continuará a aplicar as atualizações mesmo que seja encontrado um erro.

Parâmetros

-Confirm

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

Tipo:	SwitchParameter
Aliases:	cf
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ContinueOnError

Indica se as atualizações de software devem ser aplicadas à imagem mesmo quando existe um erro.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CustomSchedule

Especifica a data e hora em que as atualizações de software são aplicadas à imagem do sistema operativo.

Tipo:	DateTime
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Id

Especifica o ID de uma imagem do sistema operativo.

Tipo:	String
Aliases:	PackageId
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputObject

Especifica um objeto de imagem do sistema operativo. Para obter um objeto de imagem do sistema operativo, utilize o cmdlet Get-CMOperatingSystemImage .

Tipo:	IResultObject
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-Name

Especifica o nome de uma imagem do sistema operativo.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RemoveSupersededUpdates

{{ Fill RemoveSupersedUpdates Description }}

Tipo:	Boolean
Aliases:	CleanUp
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RunNow

Indica que a atualização deve ser executada agora.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SoftwareUpdate

Especifica uma matriz de objetos de atualização de software. Para obter um objeto de atualização de software, utilize o cmdlet Get-CMSoftwareUpdate .

Tipo:	IResultObject[]
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UpdateDistributionPoint

Indica se a imagem do sistema operativo nos pontos de distribuição é atualizada após a aplicação das atualizações de software.

Tipo:	Boolean
Aliases:	UpdateDistributionPointsWithImage, UpdateDistributionPoints
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Utc

Indica se deve utilizar a hora UTC.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject

Links Relacionados

• Get-CMOperatingSystemImageUpdateSchedule
• Clear-CMOperatingSystemImageUpdateSchedule