Set-CMApplicationDeployment
Configurar uma implantação de aplicativo
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 implantação de aplicativo no Configuration Manager. Para obter mais informações, consulte Implantar aplicativos com Configuration Manager.
Para especificar uma implantação de aplicativo a ser modificada, especifique o nome da coleção e o aplicativo. Você pode especificar um aplicativo por nome ou ID. Você também pode usar o cmdlet Get-CMApplication para obter um aplicativo para modificar.
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: modificar a disponibilidade e o prazo para uma implantação do aplicativo
Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)
Esse comando modifica uma implantação de aplicativo para um aplicativo chamado Track System 2011 para uma coleção chamada Todos os Usuários. O comando especifica a data atual para quando o aplicativo está disponível. Ele também configura o prazo de implantação para 30 dias no futuro.
Parâmetros
-AllowRepairApp
Use esse parâmetro para configurar a opção de aplicativo de reparo ao criar uma implantação para um aplicativo.
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 a ID de um aplicativo.
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 um aplicativo.
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 esse parâmetro para $true
habilitar a configuração de implantação do aplicativo para comportamentos de instalação. Em seguida, use o cmdlet Add-CMDeploymentTypeInstallBehavior para adicionar um arquivo executável para verificar se não está em execução para que a instalação tenha êxito.
Defina esse parâmetro para $false
desabilitar essa opção nas seguintes situações:
- Quando você usa o cmdlet Remove-CMDeploymentTypeInstallBehavior para remover todos os arquivos executáveis
- Você não quer que a implantação verifique se há 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 essa implantação estiver disponível. Para obter esse objeto, use o cmdlet interno Get-Date .
Use DeadlineDateTime para especificar a atribuição de implantaçã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 ao qual o aplicativo é implantado. Para obter esse objeto, use 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 a ID da coleção à qual o aplicativo é implantado. 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 à qual o aplicativo é implantado.
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 implantaçã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 é necessário criar um alerta para uma porcentagem dos aplicativos que não são implantados. Para especificar o valor percentual, use 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 é necessário criar um alerta para uma porcentagem dos aplicativos que são implantados com êxito. Para especificar o valor percentual, use 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 essa implantação for atribuída, também conhecida como o prazo final. Para obter esse objeto, use o cmdlet interno Get-Date .
Use -AvailableDateTime para especificar quando a implantação estiver disponível.
Tipo: | DateTime |
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
Defina esse parâmetro para habilitar o $true
modo de manutenção do System Center Operations Manager para essa implantação.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-EnableSoftDeadline
Defina esse parâmetro para habilitar a $true
execuçã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 o percentual de instalação de aplicativo com falha que causa um alerta.
Especifique um inteiro de 1 a 100.
Para habilitar esse 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
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 |
-InputObject
Especifique um objeto de implantação de aplicativo a ser configurado. Para obter esse objeto, use 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 implantação ocorre mesmo se agendada fora de uma janela de manutenção.
Uma janela de manutenção é um período de tempo especificado usado para manutenção e atualizações do computador.
Se esse valor for $True
, Configuration Manager implantará o aplicativo mesmo que a hora agendada fique fora da janela de manutenção.
Se esse valor for $False
, Configuration Manager não implantará o aplicativo fora da janela. Ele aguarda até que possa ser implantado em uma 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 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 é necessário habilitar filtros de gravação para dispositivos inseridos.
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 posteriormente.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PostponeDateTime
Ao definir CreateAlertBaseOnPercentSuccess como $true
, use esse parâmetro para especificar um objeto DateTime . Configuration Manager cria um alerta de implantação quando o limite é menor que o SuccessParameterValue após essa data.
Para obter esse objeto, use o cmdlet interno 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 é necessário pré-implantar o aplicativo no dispositivo principal do usuário.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RaiseMomAlertsOnFailure
Indica se é necessário criar um alerta do Operations Manager se um cliente não instalar o aplicativo.
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 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 manutenção.
Se esse valor for $False
, o computador não será 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 esse parâmetro para $true
substituir as notificações padrão por uma janela de diálogo. É falso por padrão. Para obter mais informações, consulte Substituir notificações de brinde pela janela 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 você definir esse parâmetro como $true
, um administrador deverá aprovar uma solicitação para esse aplicativo 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 é necessário enviar um pacote de despertar para computadores antes do início da implantação.
Se esse valor for $True
, Configuration Manager tentará 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 o percentual de instalação bem-sucedida do aplicativo que causa um alerta.
Especifique um inteiro de 0 a 99.
Para habilitar esse 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 qual fuso horário usar:
-
LocalTime
: use hora local. -
UTC
: use UTC (Tempo Universal Coordenado).
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 os clientes podem baixar conteúdo em uma conexão de Internet limitada após o prazo, o que pode incorrer em despesas extras.
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 usuário.
-
DisplayAll
: exiba no Centro de Software e mostre todas as notificações. -
DisplaySoftwareCenterOnly
: exiba no Centro de Software e mostre apenas notificações de reinicializações do computador. -
HideAll
: Ocultar no Centro de Software e 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 esse objeto retornado e suas propriedades, consulte SMS_ApplicationAssignment classe WMI do servidor.
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