Set-CMApplicationDeployment
Configurar uma implantação de aplicativo
Syntax
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.
| Type: | Boolean |
| Aliases: | AllowUserRepairApplication |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationId
Especifica a ID de um aplicativo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationName
Especifica o nome de um aplicativo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Aliases: | AutoCloseExeOnInstallBehavior |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Collection
Especifique um objeto de coleção ao qual o aplicativo é implantado. Para obter esse objeto, use o cmdlet Get-CMCollection .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionId
Especifique a ID da coleção à qual o aplicativo é implantado. Por exemplo, "SMS00004".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
Especifique o nome da coleção à qual o aplicativo é implantado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Comment
Especifica um comentário opcional para a implantação.
| 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 |
-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 .
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | DateTime |
| 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
Defina esse parâmetro para habilitar o $true modo de manutenção do System Center Operations Manager para essa implantação.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableSoftDeadline
Defina esse parâmetro para habilitar a $true execução atrasada.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| 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 |
-InputObject
Especifique um objeto de implantação de aplicativo a ser configurado. Para obter esse objeto, use o cmdlet Get-CMApplicationDeployment .
| Type: | IResultObject |
| Aliases: | Application, DeploymentSummary, Assignment |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| 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 é 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PreDeploy
Indica se é necessário pré-implantar o aplicativo no dispositivo principal do usuário.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RaiseMomAlertsOnFailure
Indica se é necessário criar um alerta do Operations Manager se um cliente não instalar o aplicativo.
| 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 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequireApproval
Se você definir esse parâmetro como $true, um administrador deverá aprovar uma solicitação para esse aplicativo no dispositivo.
| Type: | Boolean |
| Aliases: | AppRequiresApproval |
| 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 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeBaseOn
Especifica qual fuso horário usar:
LocalTime: use hora local.UTC: use UTC (Tempo Universal Coordenado).
| Type: | TimeType |
| Accepted values: | LocalTime, Utc |
| 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 uma conexão de Internet limitada após o prazo, o que pode incorrer em despesas extras.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| 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
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
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, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de