Partager via


Set-CMDeploymentTypeInstallBehavior

Modifiez les fichiers exécutables qui doivent être fermés pour que l’installation de l’application réussisse.

Syntaxe

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

Description

À compter de la version 2107, utilisez cette applet de commande pour modifier les fichiers exécutables qui doivent être fermés pour que l’installation de l’application réussisse. Pour plus d’informations générales sur la fonctionnalité de comportement d’installation, consultez Vérifier l’exécution de fichiers exécutables.

Si vous utilisez PowerShell pour déployer l’application, utilisez le paramètre AutoCloseExecutable sur New-CMApplicationDeployment ou Set-CMApplicationDeployment. Ce paramètre active le paramètre de déploiement d’application pour les comportements d’installation.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Modifier le comportement d’installation du fichier exécutable

Cet exemple montre comment modifier le fichier exécutable coché sur l’application CenterApp denotepad.exe en 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"

Paramètres

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayName

Spécifiez un nom convivial pour l’exécutable spécifié afin de vous aider à l’identifier.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ExeFileName

Spécifiez le nom du fichier exécutable cible. Pour modifier ce fichier exécutable, utilisez le paramètre NewExeFileName . Pour modifier le nom convivial, utilisez le paramètre DisplayName .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifiez un objet de type de déploiement d’application pour modifier ce paramètre. Pour obtenir cet objet, utilisez l’applet de commande Get-CMDeploymentType .

Type:IResultObject
Alias:DeploymentType
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-NewExeFileName

Spécifiez le nom du nouveau fichier exécutable cible. Le client Configuration Manager vérifie si ce nom de fichier est en cours d’exécution.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_Application classe WMI du serveur.