Set-CMApplicationDeployment
Configurar uma implementação de aplicação
Sintaxe
Set-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
-InputObject <IResultObject>
[-OverrideServiceWindow <Boolean>]
[-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>]
[-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
-ApplicationId <String>
[-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-OverrideServiceWindow <Boolean>]
[-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>]
[-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
-ApplicationName <String>
[-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-OverrideServiceWindow <Boolean>]
[-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>]
[-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Set-CMApplicationDeployment modifica as propriedades de uma implementação de aplicação no Configuration Manager. Para obter mais informações, veja Implementar aplicações com o Configuration Manager.
Para especificar uma implementação de aplicação a modificar, especifique o nome da coleção e a aplicação. Pode especificar uma aplicação por nome ou ID. Também pode utilizar o cmdlet Get-CMApplication para que uma aplicação seja modificada.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1: Modificar a disponibilidade e o prazo para uma implementação de aplicação
Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)
Este comando modifica uma implementação de aplicação para uma aplicação chamada Track System 2011 para uma coleção denominada Todos os Utilizadores. O comando especifica a data atual para quando a aplicação está disponível. Também configura o prazo de implementação para 30 dias no futuro.
Parâmetros
-AllowRepairApp
Utilize este parâmetro para configurar a opção reparar a aplicação ao criar uma implementação para uma aplicação.
Tipo: | Boolean |
Aliases: | AllowUserRepairApplication |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ApplicationId
Especifica o ID de uma aplicação.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ApplicationName
Especifica o nome de uma aplicação.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-AutoCloseExecutable
A partir da versão 2107, defina este parâmetro como para $true
ativar a definição de implementação de aplicações para comportamentos de instalação. Em seguida, utilize o cmdlet Add-CMDeploymentTypeInstallBehavior para adicionar um ficheiro executável para verificar se a instalação não está em execução.
Defina este parâmetro como para $false
desativar esta opção nas seguintes situações:
- Quando utiliza o cmdlet Remove-CMDeploymentTypeInstallBehavior para remover todos os ficheiros executáveis
- Não quer que a implementação verifique se existem executáveis em execução.
Tipo: | Boolean |
Aliases: | AutoCloseExeOnInstallBehavior |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-AvailableDateTime
Especifique um objeto DateTime para quando esta implementação estiver disponível. Para obter este objeto, utilize o cmdlet incorporado Get-Date .
Utilize DeadlineDateTime para especificar a atribuição de implementação ou o prazo.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Collection
Especifique um objeto de coleção para o qual a aplicação é implementada. Para obter este objeto, utilize o cmdlet Get-CMCollection .
Tipo: | IResultObject |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-CollectionId
Especifique o ID da coleção na qual a aplicação é implementada. Por exemplo, "SMS00004"
.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-CollectionName
Especifique o nome da coleção na qual a aplicação é implementada.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | True |
-Comment
Especifica um comentário opcional para a implementação.
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 |
-CreateAlertBaseOnPercentFailure
Indica se pretende criar um alerta para uma percentagem das aplicações que não são implementadas. Para especificar o valor de percentagem, utilize o parâmetro FailParameterValue .
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-CreateAlertBaseOnPercentSuccess
Indica se pretende criar um alerta para uma percentagem das aplicações que são implementadas com êxito. Para especificar o valor de percentagem, utilize o parâmetro SuccessParameterValue .
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DeadlineDateTime
Especifique um objeto DateTime para quando esta implementação é atribuída, também conhecido como prazo limite. Para obter este objeto, utilize o cmdlet incorporado Get-Date .
Utilize -AvailableDateTime para especificar quando a implementação está disponível.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. 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
Defina este parâmetro como para $true
ativar o modo de manutenção do System Center Operations Manager para esta implementação.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-EnableSoftDeadline
Defina este parâmetro como para $true
ativar a imposição atrasada.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-FailParameterValue
Especifica a percentagem de instalação falhada da aplicação que causa um alerta.
Especifique um número inteiro de 1 a 100.
Para ativar este alerta, defina o parâmetro CreatAlertBaseOnPercentFailure como $True
.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). 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 |
-InputObject
Especifique um objeto de implementação de aplicação a configurar. Para obter este objeto, utilize o cmdlet Get-CMApplicationDeployment .
Tipo: | IResultObject |
Aliases: | Application, DeploymentSummary, Assignment |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-OverrideServiceWindow
Indica se a implementação ocorre mesmo que seja agendada fora de uma janela de manutenção.
Uma janela de manutenção é um período de tempo especificado utilizado para manutenção e atualizações do computador.
Se este valor for $True
, o Configuration Manager implementa a aplicação mesmo que a hora agendada fique fora da janela de manutenção.
Se este valor for $False
, o Configuration Manager não implementa a aplicação fora da janela. Aguarda até poder ser implementado numa janela disponível.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PassThru
Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer 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 pretende ativar filtros de escrita para dispositivos incorporados.
Para um valor de $True
, o dispositivo consolida as alterações durante uma janela de manutenção. Esta ação requer um reinício.
Para um valor de $False
, o dispositivo guarda as alterações numa sobreposição e consolida-as mais tarde.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PostponeDateTime
Quando definir CreateAlertBaseOnPercentSuccess como $true
, utilize este parâmetro para especificar um objeto DateTime . O Configuration Manager cria um alerta de implementação quando o limiar é inferior ao SuccessParameterValue após esta data.
Para obter este objeto, utilize o cmdlet incorporado Get-Date .
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PreDeploy
Indica se deve pré-implementar a aplicação no dispositivo primário do utilizador.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RaiseMomAlertsOnFailure
Indica se deve criar um alerta do Operations Manager se um cliente não conseguir instalar a aplicação.
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 manutenção.
Uma janela de manutenção é um período de tempo especificado utilizado para manutenção e atualizações do computador.
Se este valor for $True
, qualquer reinício necessário ocorrerá sem ter em conta as janelas de manutenção.
Se este valor for $False
, o computador não é reiniciado 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 |
-ReplaceToastNotificationWithDialog
Quando o software necessário estiver disponível no cliente, defina este parâmetro para $true
substituir as notificações de alerta predefinidas por uma janela de caixa de diálogo. É falso por predefinição. Para obter mais informações, veja Substituir notificações de alertas pela janela da caixa de diálogo.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RequireApproval
Se definir este parâmetro como $true
, um administrador tem de aprovar um pedido para esta aplicação no dispositivo.
Tipo: | Boolean |
Aliases: | AppRequiresApproval |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SendWakeUpPacket
Indica se pretende enviar um pacote de reativação para computadores antes do início da implementação.
Se este valor for $True
, o Configuration Manager tenta reativar um computador do modo de suspensão.
Se este valor for $False
, não reativa os computadores do modo de suspensão.
Para que os computadores reativam, primeiro tem de configurar a Reativação por LAN.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SuccessParameterValue
Especifica a percentagem de instalação bem-sucedida da aplicação que causa um alerta.
Especifique um número inteiro de 0 a 99.
Para ativar este alerta, defina o parâmetro CreateAlertBaseOnPercentSuccess como $True
.
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 utilizar:
-
LocalTime
: utilize a hora local. -
UTC
: Utilize a Hora Universal Coordenada (UTC).
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 |
-UseMeteredNetwork
Indica se pretende permitir que os clientes transfiram conteúdo através de uma ligação à Internet com tráfego limitado após o prazo, o que pode incorrer em despesas adicionais.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UserNotification
Especifica o tipo de notificação do utilizador.
-
DisplayAll
: apresentar no Centro de Software e mostrar todas as notificações. -
DisplaySoftwareCenterOnly
: apresentar no Centro de Software e mostrar apenas notificações de reinícios do computador. -
HideAll
: oculte-se no Centro de Software e em todas as 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
IResultObject
Observações
Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_ApplicationAssignment classe WMI de servidor.