Set-CMApplicationDeployment

Artigo
08/17/2021

SYNOPSIS

Configure uma implementação de aplicação

SYNTAX

SetApplicationDeploymentByValueMandatory (Padrão)

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>]

SetApplicationDeploymentByIdMandatory

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>]

SetApplicationDeploymentByNameMandatory

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 Gestor de Configuração. Para obter mais informações, consulte implementar aplicações com o Gestor de Configuração.

Para especificar uma implementação de aplicação para modificar, especifique o nome da recolha e a aplicação. Pode especificar uma aplicação pelo nome ou ID. Também pode usar o cmdlet Get-CMApplication para obter uma aplicação para modificar.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Modificar a disponibilidade e o prazo para uma implementação de aplicações

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 chamada Todos os Utilizadores. O comando especifica a data atual para quando a aplicação está disponível. Também configura o prazo de implantação para 30 dias no futuro.

PARAMETERS

-AllowRepairApp

Utilize este parâmetro para configurar a opção de aplicação de reparação ao criar uma implementação para uma aplicação.

Type: Boolean
Parameter Sets: (All)
Aliases: AllowUserRepairApplication

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

-ApplicationId

Especifica a identificação de uma aplicação.

Type: String
Parameter Sets: SetApplicationDeploymentByIdMandatory
Aliases:

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

-Nome de aplicação

Especifica o nome de uma aplicação.

Type: String
Parameter Sets: SetApplicationDeploymentByNameMandatory
Aliases:

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

-AvailableDateTime

Especifique um objeto DateTime para quando esta implementação estiver disponível. Para obter este objeto, utilize o cmdlet get-date incorporado.

Use o DeadlineDateTime para especificar a atribuição de implantação ou prazo.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-Coleção

Especifique um objeto de recolha para o qual a aplicação é implantada. Para obter este objeto, utilize o cmdlet Get-CMCollection.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-CollectionId

Especificar o ID da coleção para a qual a aplicação é implantada. Por exemplo, "SMS00004".

Type: String
Parameter Sets: (All)
Aliases:

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

-Nome de coleção

Especificar o nome da coleção para a qual a aplicação está implantada.

Type: String
Parameter Sets: (All)
Aliases:

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

-Comentário

Especifica um comentário opcional para a implantação.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-CreateAlertBaseOnPercentFailure

Indica se deve criar um alerta para uma percentagem das aplicações que não conseguem implementar. Para especificar o valor percentual, utilize o parâmetro FailParameterValue.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-CreateAlertBaseOnPercentSuccess

Indica se deve criar um alerta para uma percentagem das aplicações que se desdobram com sucesso. Para especificar o valor percentual, utilize o parâmetro SuccessParameterValue.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

- DeadlineDateTime

Especifique um objeto DateTime para quando esta implementação for atribuída, também conhecida como o prazo. Para obter este objeto, utilize o cmdlet get-date incorporado.

Utilizar -AvailableDateTime para especificar quando a implementação está disponível.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableMomAlert

Deslote este parâmetro $true para permitir System Center modo de manutenção do Gestor de Operações para esta implementação.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableSoftDeadline

Desa esta definição deste parâmetro $true para permitir a execução tardia.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-FailParameterValue

Especifica a percentagem de instalação de aplicação falhada que causa um alerta. Especifique um inteiro de 1 a 100. Para ativar este alerta, desloque o parâmetro CreatAlertBaseOnPercentFailure para $True .

Type: Int32
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Especifique um objeto de implementação da aplicação para configurar. Para obter este objeto, utilize o cmdlet Get-CMApplicationDeployment.

Type: IResultObject
Parameter Sets: SetApplicationDeploymentByValueMandatory
Aliases: Application, DeploymentSummary, Assignment

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-OverrideServiceWindow

Indica se a colocação ocorre mesmo que seja programada 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 de computadores. Se este valor for $True , o Gestor de Configuração implementa a aplicação mesmo que a hora programada caia fora da janela de manutenção. Se este valor $False for, o Gestor de Configuração não implementa a aplicação fora da janela. Espera até poder implantar numa janela disponível.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

- PassThru

Adicione este parâmetro para devolver um objeto que represente o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-PersistOnWriteFilterDevice

Indica se deve ativar filtros de escrita para dispositivos incorporados. Por um valor de $True , o dispositivo comete alterações durante uma janela de manutenção. Esta ação requer um recomeço. Por um valor de $False , o dispositivo guarda alterações numa sobreposição e compromete-as mais tarde.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Adiar Hora do Natal

Quando definir CreateAlertBaseOnPercentSuccess para $true , utilize este parâmetro para especificar um objeto DateTime. O Gestor de Configuração cria um alerta de implementação quando o limiar é inferior ao SuccessParameterValue após esta data.

Para obter este objeto, utilize o cmdlet get-date incorporado.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-PreDeploy

Indica se deve pré-implantar a aplicação no dispositivo primário do utilizador.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-RaiseMomAlertsOnFailure

Indica se deve criar um alerta de Gestor de Operações se um cliente não instalar a aplicação.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-RebootOutsideServiceWindow

Indica se um computador reinicia 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 de computadores. Se este valor $True for, qualquer reinício necessário ocorre sem ter em conta as janelas de manutenção. Se este valor $False for, o computador não reinicia fora de uma janela de manutenção.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SubstituirToastNotificationWithDialog

Quando o software necessário estiver disponível no cliente, defina este parâmetro $true para substituir as notificações de torradas predefinidas por uma janela de diálogo. É falso por defeito. Para obter mais informações, consulte substituir as notificações de torradas por janela de diálogo.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Exigir a aprovação doApproval

Se definir este parâmetro para $true , um administrador deve aprovar um pedido para esta aplicação no dispositivo.

Type: Boolean
Parameter Sets: (All)
Aliases: AppRequiresApproval

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

-SendWakeUpPacket

Indica se deve enviar um pacote de despertar para os computadores antes do início da implantação. Se este valor $True for, o Gestor de Configurações tenta acordar um computador do sono. Se este valor $False for, não desperta os computadores do sono. Para que os computadores acordem, primeiro tem de configurar Wake On LAN.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SucessoParameterValue

Especifica a percentagem de instalação de aplicação bem sucedida que causa um alerta. Especifique um inteiro de 0 a 99. Para ativar este alerta, desaperte o parâmetro CreateAlertBaseOnPercentSuccess como $True .

Type: Int32
Parameter Sets: (All)
Aliases:

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

-TimeBaseOn

Especifica qual o fuso horário a utilizar:

LocalTime: Use a hora local.
UTC: Utilizar o Tempo Universal Coordenado (UTC).

Type: TimeType
Parameter Sets: (All)
Aliases:
Accepted values: LocalTime, Utc

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

-UseMeteredNetwork

Indica se permite que os clientes descarreguem conteúdo sobre uma ligação à Internet medido após o prazo, o que pode incorrer em despesas adicionais.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Notificação do Utilizador

Especifica o tipo de notificação do utilizador.

DisplayAll: Exibir no Centro de Software e mostrar todas as notificações.
DisplaySoftwareCenterOnly: Display in Software Center e apenas mostrar notificações de reiniciar o computador.
HideAll: Ocultar-se no Centro de Software e todas as notificações.

Type: UserNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, DisplaySoftwareCenterOnly, HideAll

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

-AutoCloseExecutável

A partir da versão 2107, defina este parâmetro para $true permitir a definição de implementação da aplicação para comportamentos de instalação. Em seguida, utilize o cmdlet Dedtilamento DeploymentTypeInstallBehavior para adicionar um ficheiro executável para verificar se não está a funcionar para que a instalação tenha sucesso.

Desative este parâmetro $false para desativar esta opção nas seguintes situações:

Quando utilizar o cmdlet Remove-CMDeploymentTypeInstallBehavior para remover todos os ficheiros executáveis
Não quer que a implantação verifique se há execuções executáveis.

Type: Boolean
Parameter Sets: (All)
Aliases: AutoCloseExeOnInstallBehavior

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_ApplicationAssignment

NOTAS

Para obter mais informações sobre este objeto de retorno e suas propriedades, consulte SMS_ApplicationAssignment classe WMI do servidor.

Get-CMApplication

Get-CMApplicationDeployment

Novo CMApplicationDeployment

Remoção-CMApplicationDeployment

Implementar aplicações com Gestor de Configuração

Partilhar via