Start-CMApplicationDeployment
(Preterido) Inicia uma implantação de aplicativo no Configuration Manager.
Sintaxe
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
Tipo: | Boolean |
Aliases: | AppRequiresApproval |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-AvailableDate
Tipo: | DateTime |
Aliases: | AvailiableDate |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-AvailableDateTime
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-AvailableTime
Tipo: | DateTime |
Aliases: | AvailiableTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-CollectionName
Especifica uma coleção de destino para implantar esse aplicativo.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Comment
Especifica um comentário para o aplicativo.
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 |
-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.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DeadlineDateTime
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DeployAction
Especifica uma ação para uma implantação. Os valores válidos são:
Instalar. Instale o aplicativo.
Desinstalar. Desinstale o aplicativo.
Tipo: | DeployActionType |
Valores aceitos: | Install, Uninstall |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | DeployPurposeType |
Valores aceitos: | Available, Required |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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 |
-EnableMomAlert
Indica se é necessário habilitar o modo de manutenção do Operations Manager.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-FailParameterValue
Especifica um valor que gera um alerta de implantação quando excedido.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-GenerateScomAlertOnFailure
Tipo: | Boolean |
Aliases: | RaiseMomAlertsOnFailure |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Id
Especifica uma matriz de IDs.
Tipo: | Int32 |
Aliases: | CIId, CI_ID |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InputObject
Especifica um objeto de implantação de aplicativo.
Tipo: | IResultObject |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Name
Especifica uma matriz de nomes para a implantação do aplicativo.
Tipo: | String |
Aliases: | LocalizedDisplayName |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-OverrideServiceWindow
Indica se uma instalação de aplicativo ocorre 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 |
-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.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PostponeDate
Especifica uma data após a qual criar um alerta.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PostponeDateTime
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PostponeTime
Especifica uma hora após a qual criar um alerta.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SuccessParameterValue
Especifica um valor que o limite deve exceder antes que um alerta seja criado.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | TimeType |
Valores aceitos: | LocalTime, Utc |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UpdateSupersedence
{{ Fill UpdateSupersedence Description }}
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | UserNotificationType |
Valores aceitos: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
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
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
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, consulteEnviar e exibir comentários de