Share via


New-CMSoftwareUpdateDeployment

Crie uma implantação de atualização de software.

Syntax

New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   -InputObject <IResultObject>
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateGroupId <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateGroupName <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateId <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateDeployment
   [-AcceptEula]
   [-AllowRestart <Boolean>]
   [-DeploymentName <String>]
   [-DeploymentType <DeploymentType>]
   [-Comment <String>]
   [-DisableOperationsManagerAlert <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-PercentSuccess <Int32>]
   [-ProtectedType <ProtectedType>]
   [-DeployWithNoPackage <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RestartServer <Boolean>]
   [-RestartWorkstation <Boolean>]
   [-SavedPackageId <String>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SoftwareInstallation <Boolean>]
   -SoftwareUpdateName <String>
   [-TimeBasedOn <TimeType>]
   [-TimeUnit <TimeUnitType>]
   [-TimeValue <Int32>]
   [-UnprotectedType <UnprotectedType>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-VerbosityLevel <VerbosityLevelType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-DeadlineDateTime <DateTime>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para implantar atualizações de software em uma coleção de destino.

Observação

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

Exemplos

Exemplo 1

New-CMSoftwareUpdateDeployment -DeploymentName "updates deployment" -SoftwareUpdateGroupName "software update group" -CollectionName "Desktop clients for SUM" -Description "a more detailed description of this deployment" -DeploymentType Required -VerbosityLevel AllMessages -AvailableDateTime "2020/08/25 02:00AM" -DeadlineDateTime "2020/08/26 02:00AM" -UserNotification DisplaySoftwareCenterOnly -SoftwareInstallation $True  -AllowRestart $True  -RestartServer $False -RestartWorkstation $False -PersistOnWriteFilterDevice $True -RequirePostRebootFullScan $True -ProtectedType RemoteDistributionPoint

Parâmetros

-AcceptEula

Algumas atualizações de software incluem termos de licença. Quando você implanta atualizações de software, os termos da licença não são exibidos. Adicione esse parâmetro para implantar automaticamente todas as atualizações de software, independentemente de um termo de licença associado.

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

-AllowRestart

Quando o prazo de instalação for atingido, defina esse parâmetro para permitir a $true reinicialização do sistema, se necessário, fora da janela de manutenção.

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

-AvailableDateTime

Especifique quando as atualizações de software estiverem disponíveis.

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

-Collection

Especifica um objeto de coleção no Configuration Manager a implantação será direcionada. Obtenha esse objeto com o cmdlet Get-CMCollection .

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

-CollectionId

Especifique a ID da coleção como o destino para esta implantação de atualização de software.

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

-CollectionName

Especifique o nome da coleção como o destino para esta implantação de atualização de software.

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

-Comment

Especifique uma descrição opcional para a implantação da atualização de software.

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

-Confirm

Solicita a 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

-DeadlineDateTime

Especifique um prazo de instalação para atualizações de software necessárias. Quando o prazo é atingido, o cliente instala as atualizações de software necessárias no dispositivo e reinicia o dispositivo, se necessário.

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

-DeploymentName

Especifique um nome para a implantação de atualização de software.

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

-DeploymentType

Especifique se essa implantação está disponível para os usuários instalarem ou se é uma instalação necessária no cronograma de prazo especificado.

Type:DeploymentType
Accepted values:Required, Available
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeployWithNoPackage

Defina esse parâmetro para $true não usar um pacote de implantação. Os clientes baixam conteúdo de atualização de software de pares ou da nuvem da Microsoft.

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

-DisableOperationsManagerAlert

Indica se deve desabilitar alertas do Operations Manager durante atualizações de software.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-DistributeCollectionName

O site distribui conteúdo para os grupos de pontos de distribuição associados a esse nome de coleção.

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

-DistributeContent

Adicione esse parâmetro para distribuir o conteúdo de atualização de software ao criar essa implantação. Os clientes não podem instalar as atualizações de software até que você distribua conteúdo para os pontos de distribuição que os clientes podem acessar.

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

-DistributionPointGroupName

O site distribui conteúdo para esse grupo de pontos de distribuição.

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

-DistributionPointName

O site distribui conteúdo para este ponto de distribuição.

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

-DownloadFromMicrosoftUpdate

Se o conteúdo de atualização de software não estiver disponível em um ponto de distribuição em grupos de limites atuais, vizinhos ou de sites, baixe o conteúdo do Microsoft Update.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-GenerateOperationsManagerAlert

Indica se é necessário gerar alertas do Operations Manager quando uma instalação de software falhar.

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

-GenerateSuccessAlert

Se a conformidade da implantação estiver abaixo de um limite especificado, a implantação gerará um alerta no console Configuration Manager. O limite padrão é de 95%. Para alterar o limite, use o parâmetro PercentSuccess .

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

-InputObject

Especifique um objeto de atualização de software a ser implantado.

Type:IResultObject
Aliases:SoftwareUpdate, SoftwareUpdateGroup
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PercentSuccess

Se você definir -GenerateSuccessAlert como $true, use esse parâmetro para especificar o limite de conformidade percentual no qual o site gera um alerta de console Configuration Manager. Se não for especificado, o site gerará um alerta se a implantação não atingir 95% de conformidade até o prazo especificado.

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

-PersistOnWriteFilterDevice

Indica se é necessário instalar uma atualização de software na sobreposição temporária e confirmar alterações posteriormente ou confirmar as alterações em um prazo de instalação ou em uma janela de manutenção.

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

-ProtectedType

Especifique se os clientes podem usar um ponto de distribuição de um grupo de limites vizinho ou do grupo de limites do site padrão.

Type:ProtectedType
Accepted values:NoInstall, RemoteDistributionPoint
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequirePostRebootFullScan

Esse parâmetro controla a seguinte opção de console: o software atualiza o comportamento de reavaliação de implantação após a reinicialização. Se você definir essa opção como $true, após a reinicialização dos clientes ao instalar atualizações dessa implantação, eles executarão um ciclo completo de avaliação de implantação de atualização.

Type:Boolean
Aliases:RunEvaluationAfterRestart
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestartServer

Indica se um servidor deve ser reiniciado após uma atualização de software.

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

-RestartWorkstation

Indica se uma estação de trabalho deve ser reiniciada após uma atualização de software.

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

-SavedPackageId

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

-SendWakeupPacket

Indica se é necessário enviar um pacote de despertar para computadores antes do início da implantação.

  • $True: Configuration Manager acorda um computador do sono.
  • $False: ele não acorda computadores do sono.

Para os computadores acordarem, primeiro configure Wake On LAN.

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

-SoftDeadlineEnabled

Use esse parâmetro para definir a seguinte opção na página Agenda de Implantação das configurações de implantação do ADR: atrasar a aplicação dessa implantação de acordo com as preferências do usuário, até o período de carência definido nas configurações do cliente.

Type:Boolean
Aliases:DelayEnforcementAndUpToGracePeriod
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareInstallation

Quando o prazo de instalação for atingido, defina esse parâmetro para permitir a $true instalação da atualização de software fora da janela de manutenção.

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

-SoftwareUpdateGroupId

Especifique a ID de um grupo de atualização de software a ser implantado.

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

-SoftwareUpdateGroupName

Especifique o nome de um grupo de atualização de software a ser implantado.

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

-SoftwareUpdateId

Especifique a ID de uma atualização de software a ser implantada.

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

-SoftwareUpdateName

Especifique o nome de uma atualização de software a ser implantada.

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

-TimeBasedOn

Especifique que os clientes usam hora local ou UTC para determinar a disponibilidade da implantação. O tempo UTC disponibiliza a atualização de software ao mesmo tempo para todos os computadores.

Type:TimeType
Accepted values:LocalTime, Utc
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeUnit

Especifique o tipo de valor do parâmetro -TimeValue .

Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeValue

Especifique um valor inteiro para a hora. Use o parâmetro -TimeUnit para determinar o tipo de tempo para esse valor.

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

-UnprotectedType

Quando as atualizações de software não estiverem disponíveis em nenhum ponto de distribuição no grupo de limites atual ou vizinho, especifique se os clientes podem baixar e instalar atualizações de software de pontos de distribuição no grupo de limites padrão do site.

Type:UnprotectedType
Accepted values:NoInstall, UnprotectedDistributionPoint
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseBranchCache

Indica se deve usar o Windows BranchCache para baixar conteúdo de atualização de software.

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

-UseMeteredNetwork

Indica se os clientes devem usar uma rede limitada para baixar atualizações.

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

-UserNotification

Especifique uma experiência de notificação do usuário.

  • DisplayAll: exibir no Centro de Software e mostrar todas as notificações
  • DisplaySoftwareCenterOnly: exibir no Centro de Software e mostrar apenas notificações para reinicializações do computador
  • HideAll: Ocultar no Centro de Software e todas as notificações
Type:UserNotificationType
Accepted values:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VerbosityLevel

Especifique o nível de detalhes da mensagem de estado retornado pelos clientes para esta implantação de atualização de software.

Type:VerbosityLevelType
Accepted values:AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object