Compartilhar via


Start-CMSoftwareUpdateDeployment

(Preterido) Inicia uma implantação de atualização de software no Configuration Manager.

Sintaxe

Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     -InputObject <IResultObject>
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateName <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateId <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateGroupName <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateGroupId <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Importante

Este cmdlet é preterido. Em vez disso, use New-CMSoftwareUpdateDeployment .

O cmdlet Start-CMSoftwareUpdateDeployment inicia uma implantação de atualização de software.

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: iniciar uma implantação necessária pelo nome da atualização de software

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -CollectionName "All Systems" -DeploymentName "Contoso-test" -Description "Contoso-test-deployment" -DeploymentType Required -SendWakeUpPacket $True -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -DeploymentExpireDay 2013/10/21 -DeploymentExpireTime 11:20 -UserNotification HideAll -SoftwareInstallation $True -AllowRestart $True -RestartServer $True -RestartWorkstation $True -PersistOnWriteFilterDevice $False -GenerateSuccessAlert $True -PercentSuccess 90 -TimeValue 10 -TimeUnit Days -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Este comando inicia uma implantação de atualização de software necessária usando um nome de atualização de software.

Exemplo 2: iniciar uma implantação disponível pelo nome da atualização de software

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -CollectionName "All Systems" -DeploymentName "Contoso-test2" -Description "Contoso-test2-deployment" -DeploymentType Available -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -UserNotification DisplayAll -PersistOnWriteFilterDevice $False -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Este comando inicia uma implantação de atualização de software disponível usando um nome de atualização de software.

Exemplo 3: iniciar uma implantação necessária pelo nome do grupo de atualização de software

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -CollectionName "All Systems" -DeploymentName "Contoso-test3" -Description "Contoso-test3-deployment" -DeploymentType Required -SendWakeUpPacket $True -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -DeploymentExpireDay 2013/10/21 -DeploymentExpireTime 11:20 -UserNotification HideAll -SoftwareInstallation $True -AllowRestart $True -RestartServer $True -RestartWorkstation $True -PersistOnWriteFilterDevice $False -GenerateSuccessAlert $True -PercentSuccess 90 -TimeValue 10 -TimeUnit Days -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Este comando inicia uma implantação de atualização de software usando um nome de coleção e um objeto de entrada.

Exemplo 4: iniciar uma implantação pelo nome do grupo de atualização de software

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -CollectionName "All Systems" -DeploymentName "Contoso-test4" -Description "Contoso-test4-deployment" -DeploymentType Available -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -UserNotification DisplayAll -PersistOnWriteFilterDevice $False -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

Este comando inicia uma implantação de atualização de software usando um nome de grupo de atualização de software.

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.

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

-AllowRestart

Indica se deve permitir uma reinicialização após a instalação.

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

-AllowUseMeteredNetwork

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

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

-CollectionName

Especifica um nome de uma coleção no Configuration Manager. Uma coleção é um grupo de computadores cliente.

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

-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

-DeploymentAvailableDay

Especifica um dia, no formato MM/DD/YYYY, quando uma implantação de atualização de software está disponível. Por padrão, a atualização está disponível imediatamente.

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

-DeploymentAvailableTime

Especifica uma hora, no formato HH:MM, quando uma implantação de atualização de software está disponível. Por padrão, a atualização está disponível imediatamente.

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

-DeploymentName

Especifica um nome para uma implantação de atualização de software no Configuration Manager.

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

-DeploymentType

Especifica um tipo de implantação no Configuration Manager.

Tipo:DeploymentType
Valores aceitos:Required, Available
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifica uma descrição de uma implantação de atualização de software.

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

-DisableOperationsManagerAlert

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

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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

-DownloadFromMicrosoftUpdate

Indica se os clientes baixam atualizações diretamente do Microsoft Update.

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

-EnforcementDeadline

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

-EnforcementDeadlineDay

Tipo:DateTime
Aliases:DeploymentExpireDay
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

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

-GenerateOperationsManagerAlert

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

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

-GenerateSuccessAlert

Indica se deve gerar alertas quando uma instalação de software é bem-sucedida.

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

-InputObject

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

-PercentSuccess

Especifica um êxito percentual.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

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

-ProtectedType

Especifica um tipo protegido.

Tipo:ProtectedType
Valores aceitos:NoInstall, RemoteDistributionPoint
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RestartServer

Indica se um servidor deve ser reiniciado após uma atualização de software. Definir esse valor como $True impede que o servidor reinicie. Definir esse valor como $False permite que o servidor reinicie.

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

-RestartWorkstation

Indica se uma estação de trabalho deve ser reiniciada após uma atualização de software. Definir esse valor como $True impede que o computador reinicie. Definir esse valor como $False permite que o computador reinicie.

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

-SendWakeupPacket

Indica se é necessário enviar um pacote de despertar para computadores antes do início da implantação. Se esse valor for $True, Configuration Manager acordará um computador do sono. Se esse valor for $False, ele não acordará os computadores do sono. Para que os computadores ativem, primeiro você deve configurar o Wake On LAN.

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

-SoftwareInstallation

Indica se é necessário permitir a instalação da atualização de software, mesmo que a instalação ocorra fora de uma janela de manutenção.

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

-SoftwareUpdateGroupId

Especifica uma ID para um grupo de atualização de software. Um grupo de atualização de software contém atualizações de software individuais.

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

-SoftwareUpdateGroupName

Especifica um nome para um grupo de atualização de software.

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

-SoftwareUpdateId

Especifica uma ID para uma atualização de software em Configuration Manager.

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

-SoftwareUpdateName

Especifica um nome para uma atualização de software no Configuration Manager.

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

-TimeBasedOn

Especifica que os computadores cliente usam hora local ou UTC para determinar a disponibilidade de um programa. O tempo UTC disponibiliza a atualização de software ao mesmo tempo para todos os computadores.

Tipo:TimeType
Valores aceitos:LocalTime, Utc
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeUnit

Especifica a unidade de tempo no Configuration Manager. Os valores válidos são:

  • Dias
  • Horas
  • Meses
  • Semanas
Tipo:TimeUnitType
Valores aceitos:Hours, Days, Weeks, Months
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeValue

Especifica um valor de tempo nas unidades especificadas no parâmetro TimeUnit .

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

-UnprotectedType

Especifica um tipo desprotegido.

Tipo:UnprotectedType
Valores aceitos:NoInstall, UnprotectedDistributionPoint
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UseBranchCache

Indica se deve usar o Cache de Branch como ponto de distribuição para atualizações.

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

-UserNotification

Especifica um tipo de notificação do usuário.

Tipo:UserNotificationType
Valores aceitos:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VerbosityLevel

Especifica o nível de verbosidade. Os valores válidos são:

  • AllMessages
  • OnlyErrorMessages
  • OnlySuccessAndErrorMessages
Tipo:VerbosityLevelType
Valores aceitos:AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
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

System.Object