Share via

Start-CMApplicationDeployment

  • Referência
Módulo:
ConfigurationManager

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

Syntax

Start-CMApplicationDeployment
     [-ApprovalRequired <Boolean>]
     [-AvailableDate <DateTime>]
     [-AvailableDateTime <DateTime>]
     [-AvailableTime <DateTime>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeadlineDate <DateTime>]
     [-DeadlineDateTime <DateTime>]
     [-DeadlineTime <DateTime>]
     [-DeployAction <DeployActionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-EnableMomAlert <Boolean>]
     [-FailParameterValue <Int32>]
     [-GenerateScomAlertOnFailure <Boolean>]
     [-InputObject] <IResultObject>
     [-OverrideServiceWindow <Boolean>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-PostponeDate <DateTime>]
     [-PostponeDateTime <DateTime>]
     [-PostponeTime <DateTime>]
     [-PreDeploy <Boolean>]
     [-RebootOutsideServiceWindow <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SuccessParameterValue <Int32>]
     [-TimeBaseOn <TimeType>]
     [-UpdateSupersedence <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMApplicationDeployment
     [-ApprovalRequired <Boolean>]
     [-AvailableDate <DateTime>]
     [-AvailableDateTime <DateTime>]
     [-AvailableTime <DateTime>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeadlineDate <DateTime>]
     [-DeadlineDateTime <DateTime>]
     [-DeadlineTime <DateTime>]
     [-DeployAction <DeployActionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-EnableMomAlert <Boolean>]
     [-FailParameterValue <Int32>]
     [-GenerateScomAlertOnFailure <Boolean>]
     [-Id] <Int32>
     [-OverrideServiceWindow <Boolean>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-PostponeDate <DateTime>]
     [-PostponeDateTime <DateTime>]
     [-PostponeTime <DateTime>]
     [-PreDeploy <Boolean>]
     [-RebootOutsideServiceWindow <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SuccessParameterValue <Int32>]
     [-TimeBaseOn <TimeType>]
     [-UpdateSupersedence <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMApplicationDeployment
     [-ApprovalRequired <Boolean>]
     [-AvailableDate <DateTime>]
     [-AvailableDateTime <DateTime>]
     [-AvailableTime <DateTime>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeadlineDate <DateTime>]
     [-DeadlineDateTime <DateTime>]
     [-DeadlineTime <DateTime>]
     [-DeployAction <DeployActionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-EnableMomAlert <Boolean>]
     [-FailParameterValue <Int32>]
     [-GenerateScomAlertOnFailure <Boolean>]
     [-Name] <String>
     [-OverrideServiceWindow <Boolean>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-PostponeDate <DateTime>]
     [-PostponeDateTime <DateTime>]
     [-PostponeTime <DateTime>]
     [-PreDeploy <Boolean>]
     [-RebootOutsideServiceWindow <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SuccessParameterValue <Int32>]
     [-TimeBaseOn <TimeType>]
     [-UpdateSupersedence <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Importante

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

O cmdlet Start-CMApplicationDeployment inicia uma implantação de aplicativo.

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 a implantação do aplicativo

PS XYZ:\> Start-CMApplicationDeployment -CollectionName "All Users" -Name "7zip" -AvaliableDate 2012/10/1 -AvaliableTime 12:45 -Comment "test" -DeadlineDate 2013/10/23 -DeadlineTime 21:12 -DeployAction Uninstall -EnableMomAlert $True -FailParameterValue 40 -OverrideServiceWindow $True -PersistOnWriteFilterDevice $False -PostponeDate 2014/2/8 -PostponeTime 11:11 -PreDeploy $True -RaiseMomAlertsOnFailure $True -RebootOutsideServiceWindow $True -SendWakeUpPacket $True -SuccessParameterValue 30 -UseMeteredNetwork $True -UserNotification DisplaySoftwareCenterOnly

Esse comando inicia uma implantação de aplicativo chamada 7zip.

Parâmetros

-ApprovalRequired

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

-AvailableDate

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

-AvailableDateTime

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

-AvailableTime

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

-CollectionName

Especifica uma coleção de destino para implantar esse aplicativo.

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

-Comment

Especifica um comentário para o aplicativo.

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

-DeadlineDate

Especifica um dia pelo qual instalar um aplicativo. A instalação da instalação será realizada automaticamente se o aplicativo não estiver instalado.

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

-DeadlineDateTime

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

-DeadlineTime

Especifica um tempo pelo qual instalar um aplicativo. A instalação da instalação será realizada automaticamente se o aplicativo não estiver instalado.

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

-DeployAction

Especifica uma ação para uma implantação. Os valores válidos são:

  • Instalar. Instale o aplicativo.

  • Desinstalar. Desinstale o aplicativo.

Type:DeployActionType
Accepted values:Install, Uninstall
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeployPurpose

Especifica a finalidade da implantação.

Os valores válidos são:

  • Disponível. Se a coleção de destino for uma coleção de dispositivos, o aplicativo estará disponível no centro de software. Se a coleção de destino for uma coleção de usuários, o aplicativo estará disponível no site do catálogo.

  • Obrigatório. A instalação ocorre quando o prazo passa.

Type:DeployPurposeType
Accepted values:Available, Required
Position:Named
Default value:None
Required:False
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

-EnableMomAlert

Indica se é necessário habilitar o modo de manutenção do Operations Manager.

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

-FailParameterValue

Especifica um valor que gera um alerta de implantação quando excedido.

Type:Int32
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

-GenerateScomAlertOnFailure

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

-Id

Especifica uma matriz de IDs.

Type:Int32
Aliases:CIId, CI_ID
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifica um objeto de implantação de aplicativo.

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

-Name

Especifica uma matriz de nomes para a implantação do aplicativo.

Type:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OverrideServiceWindow

Indica se uma instalação de aplicativo ocorre fora de uma janela de manutenção.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-PersistOnWriteFilterDevice

Indica se deve confirmar alterações em um dispositivo Windows Embedded no prazo ou durante uma janela de manutenção. Caso contrário, as alterações serão escritas na sobreposição e confirmadas posteriormente.

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

-PostponeDate

Especifica uma data após a qual criar um alerta.

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

-PostponeDateTime

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

-PostponeTime

Especifica uma hora após a qual criar um alerta.

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

-PreDeploy

Indica se é necessário copiar software para um dispositivo antes da instalação. Para usar esse parâmetro, defina o parâmetro DeployPurpose como Obrigatório.

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

-RebootOutsideServiceWindow

Indica se um computador é reiniciado fora de uma janela de serviço. Uma janela de serviç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 serviço. Se esse valor for $False, o computador não será reiniciado fora de uma janela de serviço.

Type:Boolean
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

-SuccessParameterValue

Especifica um valor que o limite deve exceder antes que um alerta seja criado.

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

-TimeBaseOn

Especifica o fuso horário a ser usado.

Os valores válidos são:

  • Localtime. Use a hora local.
  • Utc. Use UTC (Tempo Universal Coordenado), também conhecido como Horário Médio de Greenwich.
Type:TimeType
Accepted values:LocalTime, Utc
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpdateSupersedence

{{ Fill UpdateSupersedence Description }}

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

-UseMeteredNetwork

Indica se os clientes podem baixar conteúdo em conexões de Internet limitadas após o prazo de instalação. Os clientes podem incorrer em custos adicionais.

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

-UserNotification

Especifica tipos de notificação do usuário.

Os valores válidos são:

  • DisplayAll. Exiba no Centro de Software e mostre todas as notificações.

  • DisplaySoftwareCenterOnly. Exiba no Centro de Software e mostre apenas notificações para reinicializações do computador.

  • HideAll. Não exiba no Centro de Software e não mostre notificações.

Type:UserNotificationType
Accepted values:DisplayAll, DisplaySoftwareCenterOnly, HideAll
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