Set-CMApplicationDeployment
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.