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.