Start-CMPackageDeployment
(Preterido) Inicia a implantação de um pacote de software para uma coleção configuration Manager.
Syntax
Start-CMPackageDeployment
[-AllowSharedContent <Boolean>]
-CollectionName <String>
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentExpireDay <DateTime>]
[-DeploymentExpireTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-FastNetworkOption <FastNetworkOptionType>]
[-Package] <IResultObject>
[-PassThru]
[-PersistOnWriteFilterDevice <Boolean>]
-ProgramName <String>
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
[-StandardProgram]
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
[-AllowSharedContent <Boolean>]
-CollectionName <String>
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentExpireDay <DateTime>]
[-DeploymentExpireTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-FastNetworkOption <FastNetworkOptionType>]
-PackageName <String>
[-PassThru]
[-PersistOnWriteFilterDevice <Boolean>]
-ProgramName <String>
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
[-StandardProgram]
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
[-AllowSharedContent <Boolean>]
-CollectionName <String>
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentExpireDay <DateTime>]
[-DeploymentExpireTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-FastNetworkOption <FastNetworkOptionType>]
-PackageId <String>
[-PassThru]
[-PersistOnWriteFilterDevice <Boolean>]
-ProgramName <String>
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
[-StandardProgram]
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
[-AllowSharedContent <Boolean>]
-CollectionName <String>
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentExpireDay <DateTime>]
[-DeploymentExpireTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-FastNetworkOption <FastNetworkOptionType>]
[-PassThru]
[-PersistOnWriteFilterDevice <Boolean>]
[-Program] <IResultObject>
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
[-StandardProgram]
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
-CollectionName <String>
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
[-DeploymentStartDay <DateTime>]
[-DeploymentStartTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-DeviceProgram]
-PackageName <String>
[-PassThru]
-ProgramName <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtc <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
-CollectionName <String>
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
[-DeploymentStartDay <DateTime>]
[-DeploymentStartTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-DeviceProgram]
-PackageId <String>
[-PassThru]
-ProgramName <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtc <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
-CollectionName <String>
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
[-DeploymentStartDay <DateTime>]
[-DeploymentStartTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-DeviceProgram]
[-Package] <IResultObject>
[-PassThru]
-ProgramName <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtc <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
-CollectionName <String>
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
[-DeploymentStartDay <DateTime>]
[-DeploymentStartTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-DeviceProgram]
[-PassThru]
[-Program] <IResultObject>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtc <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Importante
Este cmdlet está preterido. Use New-CMPackageDeployment.
O cmdlet Start-CMPackageDeployment inicia a implantação de um pacote de software especificado para computadores que pertencem a uma coleção Configuration Manager. Você pode escolher quando o pacote se torna disponível e quando a implantação do pacote expira. Você pode especificar se o Configuration Manager implanta o pacote apenas uma vez ou repetidamente e o que acontece quando a instalação falha em um computador.
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: Iniciar uma implantação recorrente
PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "DPM for all systems." -DeploymentStartDay 2012/10/26 -DeploymentStartTime 12:12 -RecurUnit Days -RecurValue 7 -Rerun $True -UseMeteredNetwork $True -UseUtc $True
Este comando inicia a implantação de um pacote nomeado para a coleção chamada All Systems para o programa de dispositivo chamado DPM. O comando especifica um dia de início e hora de início. O comando inclui um comentário descritivo. O parâmetro Rerun tem um valor de $True e o comando especifica um valor de recorrência de sete e uma unidade de repetição de Dias, portanto, a implantação é reprisada a cada sete dias. A implantação usa rede monitorada. A implantação usa o tempo UTC.
Exemplo 2: Iniciar uma implantação recorrente para um pacote disponível
PS XYZ:\> Start-CMPackageDeployment -CollectionName "Western Computers" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "Deployment for Western office." -DeployPurpose Available -Rerun $True -UseUtc $True
Este comando inicia a implantação de um pacote nomeado para a coleção chamada Western Computers para o programa de dispositivo chamado DPM. O comando inclui um comentário descritivo. O comando especifica Available como DeployPurpose, para que os usuários possam decidir se instalarão esse software. O parâmetro Rerun tem um valor de $True. A implantação usa o tempo UTC.
Exemplo 3: Iniciar uma implantação para um programa padrão
PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" AllowSharedContent $False
Este comando inicia uma implantação de um pacote chamado User State Migration Tool para Windows 8 para a coleção chamada All Systems para o programa padrão chamado SPM. O comando não permite que os computadores usem conteúdo compartilhado.
Parâmetros
-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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifica a ID de um dispositivo ou conjunto de usuários.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Comentário
Especifica um comentário para a implantação.
Type: | String |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentAvailableDateTime
Especifica, como um objeto DateTime, a data e a hora em que a implantação fica disponível. 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 |
-DeploymentAvailableDay
Obsoleto. Use DeploymentAvailableDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentAvailableTime
Obsoleto. Use DeploymentAvailableDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentExpireDateTime
Especifica, como um objeto DateTime, a data e a hora em que a implantação expira. 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 |
-DeploymentExpireDay
Obsoleto. Use DeploymentExpireDateTime em vez disso.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentExpireTime
Obsoleto. Use DeploymentExpireDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentStartDateTime
Especifica, como um objeto DateTime, a data e a hora em que a implantação é iniciada. 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 |
-DeploymentStartDay
Obsoleto. Use DeploymentStartDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentStartTime
Obsoleto. Use DeploymentStartDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployPurpose
Especifica a finalidade da implantação. Os valores aceitáveis para esse parâmetro são:
- Disponível
- Obrigatório
Type: | DeployPurposeType |
Accepted values: | Available, Required |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeviceProgram
Especifica um programa de dispositivo.
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 |
-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 |
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
Especifica um objeto package. Para obter um objeto package, use o cmdlet Get-CMPackage.
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PackageId
Especifica a ID de um pacote.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageName
Especifica o nome de um pacote.
Type: | String |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
Indica se é possível habilitar filtros de gravação para dispositivos incorporados. 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 mais tarde.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Program
Especifica um programa.
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProgramName
Especifica o nome de um programa.
Type: | String |
Aliases: | StandardProgramName, DeviceProgramName |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RecurValue
Especifica a frequência com que uma implantação é 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 Hours, entre 1 e 31 se a unidade for Days ou entre 1 e 59 se a unidade for Minutes.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Rerun
Indica se a implantação será reprisada. Se esse valor for $True, a implantação será novamente executado para clientes, conforme especificado no parâmetro RerunBehavior. Se esse valor for $False, a implantação não será executado novamente.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RerunBehavior
Especifica como uma implantação é reprisada em um cliente. Os valores aceitáveis para esse parâmetro são:
- AlwaysRerunProgram. Reprise conforme agendado, mesmo que a implantação tenha êxito. Você pode usar esse valor para implantações recorrentes.
- NeverRerunDeployedProgram. Não é reprisado, mesmo que a implantação tenha falhado ou os arquivos alterados.
- RerunIfFailedPreviousAttempt. Reprise, conforme agendado, se a implantação falhou na tentativa anterior.
- RerunIfSucceededOnpreviousAttempt. Reprise somente se a tentativa anterior tiver êxito. Você pode usar esse valor para atualizações que dependem da atualização anterior.
Type: | RerunBehaviorType |
Accepted values: | NeverRerunDeployedProgram, AlwaysRetunProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Schedule
Especifica um objeto schedule para a implantação.
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Type: | ScheduleEventType |
Accepted values: | AsSoonAsPossible, LogOn, LogOff |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
Indica se é preciso enviar um pacote de alerta 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á os computadores do sono. Para que os computadores acordem, você deve primeiro configurar Wake On LAN.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SlowNetworkOption
Especifica como o 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareInstallation
Indica se o software implantado deve ser instalado fora das janelas de manutenção. Uma janela de manutenção é um período especificado de tempo usado para manutenção e atualizações do computador. Se esse valor for $True, o Gerenciador de Configurações instalará o software de acordo com o cronograma, mesmo se o cronograma ficar fora de uma janela de manutenção. Se esse valor for $False, o Configuration Manager não instalará software implantado fora de nenhuma janela, mas aguardará uma janela de manutenção.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StandardProgram
Indica que o tipo de programa no pacote de implantação é um programa padrão.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
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 especificado de tempo usado para manutenção e atualizações do computador. Se esse valor for $True, qualquer reinicialização necessária ocorrerá sem levar em consideração 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseMeteredNetwork
Indica se os clientes podem baixar conteúdo em uma conexão de Internet com um limite após o prazo, o que pode incorrer em despesas adicionais.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtc
Indica se será usado o UTC (Tempo Universal Coordenado), também conhecido como Hora média de Greenwich. Se esse valor for $True, o Configuration Manager usará UTC para essa implantação. Se esse valor for $False, o Configuration Manager usará o horário local.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtcForAvailableSchedule
Indica se o UTC deve ser usado para agendamento disponível. Se esse valor for $True, o Configuration Manager usará UTC. Se esse valor for $False, o Configuration Manager usará o horário local.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtcForExpireSchedule
Indica se o UTC deve ser usado para o cronograma de expiração. Se esse valor for $True, o Configuration Manager usará UTC. Se esse valor for $False, o Configuration Manager usará o horário 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: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object