Set-CMPackageDeployment
Altera valores que definem como Configuration Manager implanta um pacote de software.
Syntax
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 valores que definem como Configuration Manager implanta um pacote de software. Uma implantação inclui uma coleção de dispositivos ou usuários, um pacote a ser implantado e um nome do programa de dispositivo ou um nome de programa padrão. Para especificar qual implantação modificar, especifique o nome da coleção, o pacote e o nome do programa. Você pode especificar o pacote por nome ou ID ou usar o cmdlet Get-CMPackage para obter um objeto de pacote.
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: Definir propriedades de recorrência
PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -RecurUnit Hours -RecurValue 7 -UseRecurrencePattern $TrueEsse comando faz alterações na implantação especificada pela coleção denominada All Systems, o programa de dispositivo chamado DPM e o pacote chamado Ferramenta de Migração de Estado do Usuário para Windows 8. O comando define o parâmetro UseRecurrencePattern como um valor de $True. O comando especifica uma unidade recur de Horas e um valor de repetição de sete. Portanto, a implantação se repetirá a cada sete horas.
Exemplo 2: Definir dia e 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 $FalseEsse comando faz alterações na implantação especificada pela coleção chamada All Systems, o pacote chamado Ferramenta de Migração de Estado do Usuário para Windows 8 e o programa padrão chamado SPM. O comando especifica um dia e hora em que a implantação fica disponível. O comando também especifica que a implantação não usa UTC para o agendamento de disponibilidade. A agenda refere-se ao fuso horário local.
Parâmetros
-AllowFallback
{{ Preencher Descrição do AllowFallback }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowSharedContent
Indica se os clientes usam conteúdo compartilhado. Se esse valor for $True, os clientes tentarão baixar conteúdo de outros clientes que baixaram esse conteúdo. Se esse valor for $False, os clientes não tentarão baixar de outros clientes.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Collection
Especifica a coleção de usuários.
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionId
Especifica a ID de um dispositivo ou coleção de usuários.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
Especifica a ID de um dispositivo ou coleção de usuários.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Comment
Especifica um comentário para a implantação.
| Type: | String |
| 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: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentAvailableDateTime
Especifica, como um objeto DateTime , a data e hora em que a implantação se torna disponível. Para obter um objeto DateTime , use o cmdlet Get-Date.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentExpireDateTime
Especifica, como um objeto DateTime , a data e hora em que a implantação expira. Para obter um objeto DateTime , use o cmdlet Get-Date .
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentStartDateTime
Especifica, como um objeto DateTime , a data e hora que a implantação inicia. Para obter um objeto DateTime , use o cmdlet Get-Date .
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeviceProgramName
Especifica o nome de um programa de dispositivo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-EnableExpireSchedule
Indica se é necessário habilitar o agendamento para expirar a implantação.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FastNetworkOption
Especifica o comportamento do cliente em uma rede rápida. Os valores aceitáveis para esse parâmetro são:
- DownloadContentFromDistributionPointAndRunLocally
- RunProgramFromDistributionPoint
| Type: | FastNetworkOptionType |
| Accepted values: | RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally |
| 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 |
-InputObject
Especifica um objeto de pacote.
| Type: | IResultObject |
| Aliases: | Package, DeploymentSummary, Advertisement |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PackageId
Especifica a ID de um pacote.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageName
Especifica o nome de um pacote.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Retorna o objeto de trabalho atual. Por padrão, esse cmdlet não gera saída.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
Indica se é necessário habilitar filtros de gravação para dispositivos inseridos. Para um valor de $True, o dispositivo confirma alterações durante uma janela de manutenção. Essa ação requer uma reinicialização. Para um valor de $False, o dispositivo salva alterações em uma sobreposição e as confirma posteriormente.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecurUnit
Especifica uma unidade para uma implantação recorrente. Os valores aceitáveis para esse parâmetro são:
- Dias
- Horas
- Minutos
| Type: | RecurUnitType |
| Accepted values: | Minutes, Hours, Days |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecurValue
Especifica a frequência com que uma implantação se recursa. Esse parâmetro depende do tipo de unidade especificado no parâmetro RecurUnit . Esse valor pode estar 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Rerun
Indica se a implantação é executada novamente. Se esse valor for $True, a implantação será executada novamente para clientes, conforme especificado no parâmetro RerunBehavior . Se esse valor for $False, a implantação não será executada novamente.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RerunBehavior
Especifica como uma implantação é executada novamente em um cliente. Os valores aceitáveis para esse parâmetro são:
- AlwaysRerunProgram. Execute novamente como agendado, mesmo que a implantação tenha sido bem-sucedida. Você pode usar esse valor para implantações recorrentes.
- NeverRerunDeployedProgram. Não é executado novamente, mesmo que a implantação tenha falhado ou os arquivos alterados.
- RerunIfFailedPreviousAttempt. Execute novamente, conforme agendado, se a implantação falhou na tentativa anterior.
- RerunIfSucceededOnpreviousAttempt. Execute novamente somente se a tentativa anterior tiver sido bem-sucedida. Você pode usar esse valor para atualizações que dependem da atualização anterior.
| Type: | RerunBehaviorType |
| Accepted values: | NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunFromSoftwareCenter
Indica se deve ser executado no centro de software.
| Type: | Boolean |
| Aliases: | AllowUsersRunIndependently |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Schedule
Especifica um objeto CMSchedule . A agenda especifica quando ocorre a janela de manutenção. Para criar um objeto CMSchedule , use o cmdlet New-CMSchedule .
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScheduleEvent
Especifica uma matriz de tipos de evento de agendamento. Os valores aceitáveis para esse parâmetro são:
- AsSoonAsPossible
- LogOff
- LogOn
- SendWakeUpPacket
| Type: | ScheduleEventType[] |
| Accepted values: | AsSoonAsPossible, LogOn, LogOff |
| 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. 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SlowNetworkOption
Especifica como Configuration Manager implanta esse pacote em uma rede lenta. Os valores aceitáveis para esse parâmetro são:
- DoNotRunProgram
- DownloadContentFromDistributionPointAndLocally
- RunProgramFromDistributionPoint
| Type: | SlowNetworkOptionType |
| Accepted values: | DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SoftwareInstallation
Indica se é necessário instalar o software implantado fora das janelas de manutenção. Uma janela de manutenção é um período de tempo especificado usado para manutenção e atualizações do computador. Se esse valor for $True, o Configuration Manager instalará o software de acordo com o agendamento, mesmo que a agenda fique fora de uma janela de manutenção. Se esse valor for $False, Configuration Manager não instalará software implantado fora de nenhuma janela, mas aguarda uma janela de manutenção.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StandardProgramName
Especifica um nome de programa padrão.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 usado para manutenção e atualizações do computador. Se esse valor for $True, qualquer reinicialização necessária ocorrerá sem considerar as janelas de manutenção. Se esse valor for $False, o computador não será reiniciado fora de uma janela de manutenção.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseMeteredNetwork
{{ Preenchimento UseMeteredNetwork Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseRecurrencePattern
Indica se deve usar um padrão de recorrência.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUtc
Indica se deve usar o UTC (Tempo Universal Coordenado), também conhecido como Horário Médio de Greenwich. Se esse valor for $True, Configuration Manager usará UTC para essa implantação. Se esse valor for $False, Configuration Manager usará a hora local.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUtcForAvailableSchedule
Indica se deve usar o UTC para agendamento disponível. Se esse valor for $True, Configuration Manager usará UTC. Se esse valor for $False, Configuration Manager usará a hora local.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUtcForExpireSchedule
Indica se deve usar o UTC para expirar o agendamento. Se esse valor for $True, Configuration Manager usará UTC. Se esse valor for $False, Configuration Manager usará a hora local.
| Type: | Boolean |
| 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: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object
Links Relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de