Set-CMPackageDeployment

  • Referência
Módulo:
ConfigurationManager

Altera valores que definem a forma como o Configuration Manager implementa um pacote de software.

Sintaxe

Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -InputObject <IResultObject>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageName <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageId <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageId <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -InputObject <IResultObject>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-CMPackageDeployment altera os valores que definem a forma como o Configuration Manager implementa um pacote de software. Uma implementação inclui uma coleção de dispositivos ou utilizadores, um pacote para implementar e um nome de programa de dispositivo ou um nome de programa padrão. Para especificar a implementação a modificar, especifique o nome da coleção, o pacote e o nome do programa. Pode especificar o pacote por nome ou ID ou pode utilizar o cmdlet Get-CMPackage para obter um objeto de pacote.

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: Definir propriedades de periodicidade

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -RecurUnit Hours -RecurValue 7 -UseRecurrencePattern $True

Este comando efetua alterações à implementação especificada pela coleção denominada Todos os Sistemas, o programa de dispositivos com o nome DPM e o pacote denominado User State Migration Tool para Windows 8. O comando define o parâmetro UseRecurrencePattern como um valor de $True. O comando especifica uma unidade recorrente de Horas e um valor periódico de sete. Por conseguinte, a implementação repete-se a cada sete horas.

Exemplo 2: Definir o dia e a hora de disponibilidade

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" -DeploymentAvailableDay 2012/10/18 -DeploymentAvailableTime 15:41 -UseUtcForAvailableSchedule $False

Este comando efetua alterações à implementação especificada pela coleção denominada Todos os Sistemas, o pacote denominado User State Migration Tool para Windows 8 e o programa padrão com o nome SPM. O comando especifica um dia e uma hora em que a implementação fica disponível. O comando também especifica que a implementação não utiliza UTC para o agendamento de disponibilidade. A agenda refere-se ao fuso horário local.

Parâmetros

-AllowFallback

{{ Fill AllowFallback Description }}

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

-AllowSharedContent

Indica se os clientes utilizam conteúdo partilhado. Se este valor for $True, os clientes tentam transferir conteúdo de outros clientes que transferiram esse conteúdo. Se este valor for $False, os clientes não tentam transferir a partir de outros clientes.

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

-Collection

Especifica a coleção de utilizadores.

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

-CollectionId

Especifica o ID de uma coleção de dispositivos ou utilizadores.

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

-CollectionName

Especifica o ID de uma coleção de dispositivos ou utilizadores.

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

-Comment

Especifica um comentário para a implementação.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
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

-DeploymentAvailableDateTime

Especifica, como um objeto DateTime , a data e hora em que a implementação fica disponível. Para obter um objeto DateTime , utilize o cmdlet Get-Date.

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

-DeploymentExpireDateTime

Especifica, como um objeto DateTime , a data e hora em que a implementação expira. Para obter um objeto DateTime , utilize o cmdlet Get-Date .

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

-DeploymentStartDateTime

Especifica, como um objeto DateTime , a data e hora em que a implementação é iniciada. Para obter um objeto DateTime , utilize o cmdlet Get-Date .

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

-DeviceProgramName

Especifica o nome de um programa de dispositivo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
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

-EnableExpireSchedule

Indica se pretende ativar a agenda para expirar a implementação.

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

-FastNetworkOption

Especifica o comportamento do cliente numa rede rápida. Os valores aceitáveis para esse parâmetro são:

  • DownloadContentFromDistributionPointAndRunLocally
  • RunProgramFromDistributionPoint
Tipo:FastNetworkOptionType
Valores aceitos:RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
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

-InputObject

Especifica um objeto de pacote.

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

-PackageId

Especifica o ID de um pacote.

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

-PackageName

Especifica o nome de um pacote.

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

-PassThru

Devolve o objeto de trabalho atual. Por padrão, esse cmdlet não gera saída.

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

-PersistOnWriteFilterDevice

Indica se pretende ativar filtros de escrita para dispositivos incorporados. Para um valor de $True, o dispositivo consolida as alterações durante uma janela de manutenção. Esta ação requer um reinício. Para um valor de $False, o dispositivo guarda as alterações numa sobreposição e consolida-as mais tarde.

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

-RecurUnit

Especifica uma unidade para uma implementação periódica. Os valores aceitáveis para esse parâmetro são:

  • Dias
  • Horas
  • Minutos
Tipo:RecurUnitType
Valores aceitos:Minutes, Hours, Days
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RecurValue

Especifica a frequência com que uma implementação se repete. Este parâmetro depende do tipo de unidade especificado no parâmetro RecurUnit . Este valor pode ser entre 1 e 23 se a unidade for Horas, entre 1 e 31 se a unidade for Dias ou entre 1 e 59 se a unidade for Minutos.

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

-Rerun

Indica se a implementação é executada novamente. Se este valor for $True, a implementação será executada novamente para os clientes, conforme especificado no parâmetro RerunBehavior . Se este valor for $False, a implementação não será executada novamente.

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

-RerunBehavior

Especifica como uma implementação é executada novamente num cliente. Os valores aceitáveis para esse parâmetro são:

  • AlwaysRerunProgram. Execute novamente como agendado, mesmo que a implementação tenha sido bem-sucedida. Pode utilizar este valor para implementações periódicas.
  • NeverRerunDeployedProgram. Não é executada novamente, mesmo que a implementação tenha falhado ou os ficheiros sejam alterados.
  • RerunIfFailedPreviousAttempt. Execute novamente, conforme agendado, se a implementação tiver falhado na tentativa anterior.
  • RerunIfSucceededOnpreviousAttempt. Execute novamente apenas se a tentativa anterior tiver sido efetuada com êxito. Pode utilizar este valor para atualizações que dependem da atualização anterior.
Tipo:RerunBehaviorType
Valores aceitos:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunFromSoftwareCenter

Indica se deve ser executado a partir do centro de software.

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

-Schedule

Especifica um objeto CMSchedule . A agenda especifica quando ocorre a janela de manutenção. Para criar um objeto CMSchedule , utilize o cmdlet New-CMSchedule .

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

-ScheduleEvent

Especifica uma matriz de tipos de eventos de agendamento. Os valores aceitáveis para esse parâmetro são:

  • AsSoonAsPossible
  • LogOff
  • LogOn
  • SendWakeUpPacket
Tipo:ScheduleEventType[]
Valores aceitos:AsSoonAsPossible, LogOn, LogOff
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SendWakeupPacket

Indica se pretende enviar um pacote de reativação para computadores antes do início da implementação. Se este valor for $True, o Configuration Manager reativa um computador do modo de suspensão. Se este valor for $False, não reativa os computadores do modo de suspensão. Para que os computadores reativam, primeiro tem de configurar a Reativação por LAN.

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

-SlowNetworkOption

Especifica como o Configuration Manager implementa este pacote numa rede lenta. Os valores aceitáveis para esse parâmetro são:

  • DoNotRunProgram
  • DownloadContentFromDistributionPointAndLocally
  • RunProgramFromDistributionPoint
Tipo:SlowNetworkOptionType
Valores aceitos:DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SoftwareInstallation

Indica se deve instalar o software implementado fora das janelas de manutenção. Uma janela de manutenção é um período de tempo especificado utilizado para manutenção e atualizações do computador. Se este valor for $True, o Configuration Manager instala o software de acordo com o agendamento, mesmo que a agenda fique fora de uma janela de manutenção. Se este valor for $False, o Configuration Manager não instala software implementado fora de nenhuma janela, mas aguarda por 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

-StandardProgramName

Especifica um nome de programa padrão.

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

-SystemRestart

Indica se um sistema é reiniciado fora de uma janela de manutenção. Uma janela de manutenção é um período de tempo especificado utilizado para manutenção e atualizações do computador. Se este valor for $True, qualquer reinício necessário ocorrerá sem considerar as janelas de manutenção. Se este valor for $False, o computador não é reiniciado 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

-UseMeteredNetwork

{{ Fill UseMeteredNetwork Description }}

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

-UseRecurrencePattern

Indica se deve utilizar um padrão de periodicidade.

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

-UseUtc

Indica se deve utilizar a Hora Universal Coordenada (UTC), também conhecida como Hora Média de Greenwich. Se este valor for $True, o Configuration Manager utiliza UTC para esta implementação. Se este valor for $False, o Configuration Manager utiliza a hora local.

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

-UseUtcForAvailableSchedule

Indica se deve utilizar UTC para agendamento disponível. Se este valor for $True, o Configuration Manager utiliza UTC. Se este valor for $False, o Configuration Manager utiliza a hora local.

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

-UseUtcForExpireSchedule

Indica se deve utilizar UTC para agendar expiração. Se este valor for $True, o Configuration Manager utiliza UTC. Se este valor for $False, o Configuration Manager utiliza a hora local.

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

System.Object