Share via


New-CMPackageDeployment

Implante um pacote herdado em uma coleção.

Syntax

New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   [-Package] <IResultObject>
   [-PersistOnWriteFilterDevice <Boolean>]
   -ProgramName <String>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageName <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   -ProgramName <String>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageId <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   -ProgramName <String>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-Program] <IResultObject>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   -PackageName <String>
   -ProgramName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   -PackageId <String>
   -ProgramName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   [-Package] <IResultObject>
   -ProgramName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   [-Program] <IResultObject>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para implantar um pacote em recursos em uma coleção. Você pode especificar a coleção por ID, nome ou passar um objeto.

Para outras configurações de implantação que você não pode configurar com esse cmdlet, use Set-CMPackageDeployment.

Para obter mais informações, consulte Pacotes e programas no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Implantar um pacote por ID

Este comando cria uma implantação do pacote com ID XYZ00001 para a coleção com ID XYZ0003F.

$pkgId = "XYZ00001"
$collId = "XYZ0003F"
New-CMPackageDeployment -StandardProgram -PackageId $pkgId -ProgramName "ScanState" -CollectionID $collId -Comment "Use USMT to scan for data" -DeployPurpose Available

Exemplo 2: Implantar um pacote conforme necessário com um prazo

O primeiro comando define uma variável para um prazo de 10 dias a partir de agora, às 20:00. O segundo comando cria um objeto schedule com base nesse prazo que se recorre diariamente. O terceiro comando cria a implantação do pacote com essa agenda.

[datetime]$DeadlineTime = (Get-Date -Hour 20 -Minute 0 -Second 0).AddDays(10)

$NewScheduleDeadline = New-CMSchedule -Start $DeadlineTime -Nonrecurring

$pkgId = "XYZ00001"
$progName = "Run"
$collId = "XYZ0003F"

New-CMPackageDeployment -StandardProgram -PackageId $pkgId -ProgramName $progName -DeployPurpose Required -CollectionId $collId -FastNetworkOption DownloadContentFromDistributionPointAndRunLocally -SlowNetworkOption DownloadContentFromDistributionPointAndLocally -RerunBehavior RerunIfFailedPreviousAttempt -Schedule $NewScheduleDeadline

Parâmetros

-AllowFallback

Permitir que os clientes usem pontos de distribuição do grupo de limite de site padrão.

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

-AllowSharedContent

Permitir que os clientes usem pontos de distribuição de um grupo de limite de vizinhos.

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

-AvailableDateTime

Especifique quando essa implantação está disponível.

Use -DeadlineDateTime para especificar quando a implantação _expira_e -Agendar para especificar a atribuição de implantação _ou_prazo.

Para obter um objeto DateTime, use o cmdlet Get-Date.

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

-Collection

Especifique um objeto collection como o destino para a implantação deste pacote. Para obter esse objeto, use o cmdlet Get-CMCollection.

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

-CollectionId

Especifique uma ID de coleção como o destino para essa implantação de pacote.

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

-CollectionName

Especifique um nome de coleção como o destino para essa implantação de pacote.

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

-Comentário

Especifique um comentário opcional para essa implantação de pacote.

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

-Confirm

Adicione esse parâmetro para solicitar confirmação antes de executar o cmdlet.

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

-DeadlineDateTime

Use este parâmetro para especificar quando a implantação expirar.

Use -AvailableDateTime para especificar quando a implantação está disponível e -Agendar para especificar _a_atribuição de implantação ou prazo.

Para obter um objeto DateTime, use o cmdlet Get-Date.

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

-DeployPurpose

Especifique se essa implantação está disponível para os usuários instalarem ou se é necessário instalar no prazo limite.

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

-DeviceProgram

Se o programa para o pacote que você está implantando for um programa do tipo de dispositivo, especifique esse parâmetro.

Caso contrário, use o parâmetro StandardProgram. O tipo de programa padrão é para computadores com o cliente do Configuration Manager.

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-DistributeContent

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

Type:SwitchParameter
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointName

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

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

-FastNetworkOption

Especifique o comportamento quando o cliente usa um ponto de distribuição do grupo de limite atual:

  • Executar programa do ponto de distribuição
  • Baixar conteúdo do ponto de distribuição e executar localmente

Se você não especificar esse parâmetro, ele usará DownloadContentFromDistributionPointAndRunLocally por padrão. Essa opção é mais segura, pois o cliente valida o hash de conteúdo antes de executa o programa.

Type:FastNetworkOptionType
Accepted values:RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
Position:Named
Default value:None
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). Não é possível combiná-lo com DisableWildcardHandling.

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

-Package

Especifique um objeto package com o programa a ser implantado. Para obter esse objeto, use o cmdlet Get-CMPackage.

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-PackageId

Especifique a ID do pacote com o programa a ser implantado. Essa ID é uma ID de pacote padrão, por exemplo XYZ007E3 .

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

-PackageName

Especifique o nome do pacote com o programa a ser implantado.

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

-PersistOnWriteFilterDevice

Configure como o cliente lida com o filtro de gravação em Windows incorporados.

  • $true: Confirmação de alterações no prazo ou durante uma janela de manutenção. Uma reinicialização é necessária.
  • $false: Aplique conteúdo na sobreposição e confirmação posteriormente.
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Program

Especifique um objeto de programa a ser implantado. Para obter esse objeto, use o cmdlet Get-CMProgram.

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ProgramName

Especifique o nome do programa no pacote a ser implantado.

Type:String
Aliases:StandardProgramName, DeviceProgramName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RecurUnit

Especifique uma unidade para uma implantação recorrente. Use o parâmetro RecurValue para especificar o valor dessa unidade.

Type:RecurUnitType
Accepted values:Minutes, Hours, Days
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RecurValue

Especifique com que frequência a implantação se recorrência.

Esse parâmetro depende do tipo de unidade especificado no parâmetro RecurUnit:

  • Horas: Esse valor pode estar 1 entre e 23
  • Dias: Entre 1 e 31
  • Minutos: Entre 1 e 59
Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Rerun

Indicar se a implantação será reprisada:

  • $True: A implantação é executado novamente para clientes, conforme especificado no parâmetro RerunBehavior. Esse valor é o padrão.
  • $False: A implantação não é executado novamente.
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RerunBehavior

Especifique se o programa será reprisado em um computador.

  • NeverRerunDeployedProgram: Não será reprisada, mesmo que a implantação tenha falhado ou os arquivos alterados.
  • AlwaysRerunProgram: Reprise conforme agendado, mesmo que a implantação tenha êxito. Você pode usar esse valor para implantações recorrentes. Esse valor é o padrão.
  • RerunIfFailedPreviousAttempt: Reprise conforme agendado, se a implantação falhar na tentativa anterior.
  • RerunIfSucceededOnPreviousAttempt: Reprise somente se a tentativa anterior tiver êxito.
Type:RerunBehaviorType
Accepted values:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RunFromSoftwareCenter

Permitir que os usuários executem o programa independentemente das atribuições.

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

-Schedule

Use este parâmetro para especificar a atribuição de implantação ou o prazo.

Use -AvailableDateTime para especificar quando _a_implantação está disponível e -DeadlineDateTime para especificar quando a implantação expira.

Especifique uma matriz de objetos de agendamento. Um objeto schedule define o cronograma de atribuição obrigatório para uma implantação. Para criar um objeto schedule, use o cmdlet New-CMSchedule.

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

-ScheduleEvent

Especifique o tipo de evento que determina quando a implantação do pacote é executado.

Type:ScheduleEventType
Accepted values:AsSoonAsPossible, LogOn, LogOff
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SendWakeupPacket

Indica se um pacote de alerta deve ser enviado para computadores antes do início da implantação. Se esse valor for $True , o Configuration Manager acordará um computador do sono. Se esse valor for $False , ele não acordará computadores do sono. Para que os computadores acordem, primeiro configure Wake On LAN.

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

-SlowNetworkOption

Especifique o comportamento quando o cliente usa um ponto de distribuição de um grupo de limite de vizinhos ou o grupo de limite de site padrão:

  • Não executar programa
  • Baixar conteúdo do ponto de distribuição e executar localmente
  • Executar programa do ponto de distribuição

Se você não especificar esse parâmetro, ele usará DoNotRunProgram por padrão.

Type:SlowNetworkOptionType
Accepted values:DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareInstallation

Quando o prazo de instalação for atingido, de definir esse parâmetro para permitir que $true o pacote seja instalado fora da janela de manutenção.

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

-StandardProgram

Use esse parâmetro para tipos de programa padrão. Esse tipo é para computadores com o cliente do Configuration Manager.

Se o programa para o pacote que você está implantando for um programa do tipo de dispositivo, use o parâmetro DeviceProgram.

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

-SystemRestart

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

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

-UseMeteredNetwork

Indica se é possível permitir que os clientes em uma conexão de Internet com metros baixem conteúdo após o prazo de instalação, o que pode incorrer em mais custos.

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

-UseUtc

Indica se os clientes usam UTC (Tempo Universal Coordenado) para determinar a disponibilidade de um programa. O tempo UTC disponibiliza a implantação ao mesmo tempo para todos os computadores. Se você não especificar esse parâmetro ou defini-lo como $false , o cliente usará sua hora local.

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

-UseUtcForAvailableSchedule

Indica se os clientes usam UTC (Tempo Universal Coordenado) para determinar a disponibilidade de um programa. O tempo UTC disponibiliza a implantação ao mesmo tempo para todos os computadores. Se você não especificar esse parâmetro ou defini-lo como $false , o cliente usará sua hora local.

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

-UseUtcForExpireSchedule

Indica se os clientes usam o UTC (Tempo Universal Coordenado) para determinar quando um programa expira. O tempo UTC expira a implantação ao mesmo tempo para todos os computadores. Se você não especificar esse parâmetro ou defini-lo como $false , o cliente usará sua hora local.

Type:Boolean
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object