Share via

Set-CMDeploymentTypeInstallBehavior

  • Referência
Módulo:
ConfigurationManager

Modifique os arquivos executáveis que precisam ser fechado para que a instalação do aplicativo seja bem-sucedida.

Syntax

Set-CMDeploymentTypeInstallBehavior
   -InputObject <IResultObject>
   -ExeFileName <String>
   [-NewExeFileName <String>]
   [-DisplayName <String>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

A partir da versão 2107, use este cmdlet para modificar os arquivos executáveis que precisam ser fechado para que a instalação do aplicativo seja bem-sucedida. Para obter mais informações gerais sobre o recurso de comportamento de instalação, consulte Verificar se há arquivos executáveis em execução.

Se você usar o PowerShell para implantar o aplicativo, use o parâmetro AutoCloseExecutable em New-CMApplicationDeployment ou Set-CMApplicationDeployment. Esse parâmetro habilita a configuração de implantação do aplicativo para comportamentos de instalação.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Alterar o comportamento de instalação de arquivo executável

Este exemplo altera o arquivo executável verificado no aplicativo CenterApp denotepad.exe** para ** calc.exe.

$appName = "CenterApp"
$dtName = "InterDept - Windows Installer (.msi file)"
$msi_dt = Get-CMDeploymentType -ApplicationName $appName -DeploymentTypeName $dtName
Set-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -NewExeFileName "calc.exe" -DisplayName "Calculator"

Parâmetros

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-DisplayName

Especifique um nome amigável para o executável especificado para ajudá-lo a identificá-lo.

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

-ExeFileName

Especifique o nome do arquivo executável de destino. Para alterar esse arquivo executável, use o parâmetro NewExeFileName. Para alterar o nome amigável, use o parâmetro DisplayName.

Type:String
Position:Named
Default value:None
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). Não é possível combiná-lo com DisableWildcardHandling.

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

-InputObject

Especifique um objeto de tipo de implantação de aplicativo para modificar essa configuração. Para obter esse objeto, use o cmdlet Get-CMDeploymentType.

Type:IResultObject
Aliases:DeploymentType
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-NewExeFileName

Especifique o nome do novo arquivo executável de destino. O cliente do Configuration Manager verifica se esse nome de arquivo está em execução.

Type:String
Position:Named
Default value:None
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
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:None
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 de retorno e suas propriedades, consulte SMS_Application classe WMI do servidor.