Set-CMProgram
Modifier un programme d’un package.
Syntaxe
Set-CMProgram
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-AfterRunningType <AfterRunningType>]
[-Category <String>]
[-CommandLine <String>]
[-Comment <String>]
[-DisableMomAlertOnRun <Boolean>]
[-DisableProgram <Boolean>]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DriveLetter <String>]
[-DriveMode <DriveModeType>]
[-Duration <Int32>]
[-EnableTaskSequence <Boolean>]
[-GenerateMomAlertOnFail <Boolean>]
-InputObject <IResultObject>
[-PassThru]
[-ProgramAssignedType <ProgramAssignedType>]
[-ProgramRunType <ProgramRunType>]
[-Reconnect <Boolean>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-Requirement <String>]
[-RunMode <RunModeType>]
[-RunOnAnyPlatform]
[-RunType <RunType>]
[-StandardProgram]
[-SuppressProgramNotification <Boolean>]
[-UserInteraction <Boolean>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-AfterRunningType <AfterRunningType>]
[-Category <String>]
[-CommandLine <String>]
[-Comment <String>]
[-DisableMomAlertOnRun <Boolean>]
[-DisableProgram <Boolean>]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DriveLetter <String>]
[-DriveMode <DriveModeType>]
[-Duration <Int32>]
[-EnableTaskSequence <Boolean>]
[-GenerateMomAlertOnFail <Boolean>]
-PackageName <String>
[-PassThru]
[-ProgramAssignedType <ProgramAssignedType>]
-ProgramName <String>
[-ProgramRunType <ProgramRunType>]
[-Reconnect <Boolean>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-Requirement <String>]
[-RunMode <RunModeType>]
[-RunOnAnyPlatform]
[-RunType <RunType>]
[-StandardProgram]
[-SuppressProgramNotification <Boolean>]
[-UserInteraction <Boolean>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-AfterRunningType <AfterRunningType>]
[-Category <String>]
[-CommandLine <String>]
[-Comment <String>]
[-DisableMomAlertOnRun <Boolean>]
[-DisableProgram <Boolean>]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DriveLetter <String>]
[-DriveMode <DriveModeType>]
[-Duration <Int32>]
[-EnableTaskSequence <Boolean>]
[-GenerateMomAlertOnFail <Boolean>]
-PackageId <String>
[-PassThru]
[-ProgramAssignedType <ProgramAssignedType>]
-ProgramName <String>
[-ProgramRunType <ProgramRunType>]
[-Reconnect <Boolean>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-Requirement <String>]
[-RunMode <RunModeType>]
[-RunOnAnyPlatform]
[-RunType <RunType>]
[-StandardProgram]
[-SuppressProgramNotification <Boolean>]
[-UserInteraction <Boolean>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-AddSupportedOperatingSystemPlatform <IResultObject[]>]
[-AfterRunningType <AfterRunningType>]
[-Category <String>]
[-CommandLine <String>]
[-Comment <String>]
[-DisableMomAlertOnRun <Boolean>]
[-DisableProgram <Boolean>]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DriveLetter <String>]
[-DriveMode <DriveModeType>]
[-Duration <Int32>]
[-EnableTaskSequence <Boolean>]
[-GenerateMomAlertOnFail <Boolean>]
-InputObject <IResultObject>
[-PassThru]
[-ProgramAssignedType <ProgramAssignedType>]
-ProgramName <String>
[-ProgramRunType <ProgramRunType>]
[-Reconnect <Boolean>]
[-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
[-Requirement <String>]
[-RunMode <RunModeType>]
[-RunOnAnyPlatform]
[-RunType <RunType>]
[-StandardProgram]
[-SuppressProgramNotification <Boolean>]
[-UserInteraction <Boolean>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-CommandLine <String>]
[-CommandLineFolder <String>]
[-Comment <String>]
[-DeviceProgram]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DownloadProgramType <DownloadProgramType>]
-PackageName <String>
[-PassThru]
-ProgramName <String>
[-Requirement <String>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-CommandLine <String>]
[-CommandLineFolder <String>]
[-Comment <String>]
[-DeviceProgram]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DownloadProgramType <DownloadProgramType>]
-PackageId <String>
[-PassThru]
-ProgramName <String>
[-Requirement <String>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-CommandLine <String>]
[-CommandLineFolder <String>]
[-Comment <String>]
[-DeviceProgram]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DownloadProgramType <DownloadProgramType>]
-InputObject <IResultObject>
[-PassThru]
-ProgramName <String>
[-Requirement <String>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMProgram
[-CommandLine <String>]
[-CommandLineFolder <String>]
[-Comment <String>]
[-DeviceProgram]
[-DiskSpaceRequirement <String>]
[-DiskSpaceUnit <DiskSpaceUnitType>]
[-DownloadProgramType <DownloadProgramType>]
-InputObject <IResultObject>
[-PassThru]
[-Requirement <String>]
[-WorkingDirectory <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Utilisez cette applet de commande pour modifier un programme d’un package. Les programmes identifient les actions qui se produisent lorsque le client reçoit le package client. Vous pouvez associer plusieurs programmes au même package. Pour plus d’informations, consultez Packages et programmes dans Configuration Manager.
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 un programme standard
Set-CMProgram -Name "Test" -StandardProgramName SPM -Comment "Standard Upgrades" -CommandLine "RunThisNow" -RunType Maximized -AfterRunningType ProgramControlsRestart -Category "Laptops" -DiskSpaceRequirement 50 -DiskSpaceUnit MB -Duration 150 -Requirement 4 -Reconnect $False -SuppressProgramNotifications $False -DisableProgram $True -EnableTaskSequence $True -DisableMomAlertOnRun $True -GenerateMomAlertOnFail $TrueExemple 2 : Modifier un programme d’appareil
Set-CMProgram -Name "Test" -DeviceProgramName DPM -Comment "Upgrades for December" -CommandLine "RunMe" -WorkingDirectory "\TempWork" -CommandLineFolder "C:\Windows" -DiskSpaceRequirement 30 -DiskSpaceUnit MB -DownloadProgramType AsSoonAsPossible -Requirement "All previous device updates"Exemple 3 : Ajouter une plateforme de système d’exploitation prise en charge
Cet exemple définit la configuration requise du système d’exploitation pour un programme associé à un package standard. Il utilise l’applet de commande Get-CMSupportedPlatform pour obtenir un objet pour la plateforme spécifiée. Il utilise ensuite cet objet de plateforme pris en charge pour configurer le programme.
$ProgramName = 'Script'
$PackageID = 'XYZ0000D'
$Platform = 'All Windows 10 (64-bit) Client'
$OS = Get-CMSupportedPlatform -Name $Platform -Fast
Set-CMProgram -PackageID $PackageID -ProgramName $ProgramName -AddSupportedOperatingSystemPlatform $OS -StandardProgramParamètres
-AddSupportedOperatingSystemPlatform
Spécifiez une ou plusieurs plateformes de système d’exploitation prises en charge à ajouter pour le programme. Pour obtenir cet objet, utilisez l’applet de commande Get-CMSupportedPlatform .
| Type: | IResultObject[] |
| Alias: | AddSupportedOperatingSystemPlatforms |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AfterRunningType
Spécifiez l’action qui se produit une fois le programme terminé avec succès.
| Type: | AfterRunningType |
| Valeurs acceptées: | NoActionRequired, ConfigurationManagerRestartsComputer, ProgramControlsRestart, ConfigurationManagerLogsUserOff |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Category
Spécifiez la catégorie sous laquelle le programme est affiché sur l’ordinateur client.
| 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 |
-CommandLine
Spécifiez la ligne de commande du programme.
| 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 |
-CommandLineFolder
Spécifiez le dossier qui contient le programme exécutable. Ce dossier peut être un chemin absolu sur le client ou un chemin d’accès relatif au dossier de distribution qui contient le package.
| 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 |
-Comment
Spécifiez un texte facultatif sur le programme, tel qu’une description. Sur les ordinateurs clients, ce texte s’affiche avec le programme dans le Centre logiciel.
| 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 |
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DeviceProgram
Ajoutez ce paramètre pour configurer ce programme en tant que programme d’appareil.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DisableMomAlertOnRun
Indique si l’ordinateur exécutant le programme est en mode maintenance pendant la durée du programme. En mode maintenance, System Center Operations Manager désactive les alertes pendant l’exécution du programme.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DisableProgram
Définissez ce paramètre sur $true pour désactiver temporairement tous les déploiements qui contiennent ce programme. Vous pouvez également utiliser l’applet de commande Disable-CMProgram .
| Type: | Boolean |
| 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 |
-DiskSpaceRequirement
Spécifiez la quantité d’espace disque dont le logiciel a besoin pour s’exécuter sur l’ordinateur. La valeur doit être supérieure ou égale à zéro. Si vous spécifiez une valeur, utilisez le paramètre DiskSpaceUnit pour spécifier des unités pour la valeur.
| 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 |
-DiskSpaceUnit
Spécifiez une unité acceptée pour le paramètre DiskSpaceRequirement .
| Type: | DiskSpaceUnitType |
| Valeurs acceptées: | KB, MB, GB |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DownloadProgramType
Spécifiez quand le programme doit s’exécuter.
| Type: | DownloadProgramType |
| Valeurs acceptées: | AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DriveLetter
Si vous utilisez le paramètre DriveMode , spécifiez une lettre de lecteur pour l’emplacement.
| 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 |
-DriveMode
Indique si le programme nécessite une lettre de lecteur spécifique, spécifiée dans le paramètre DriveLetter .
RunWithUnc: exécutez le programme à partir du chemin UNC. Cette valeur est la valeur par défaut. À compter de la version 2010, cette valeur a été renommée à partir deRenameWithUnc.RequiresDriveLetter: le programme utilise n’importe quelle lettre de lecteur disponible.RequiresSpecificDriveLetter: le programme s’exécute uniquement si le lecteur n’est pas déjà utilisé.
| Type: | DriveModeType |
| Valeurs acceptées: | RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Duration
Spécifie la durée maximale pendant laquelle vous attendez que le programme s’exécute. La valeur par défaut est 120 minutes.
| Type: | Int32 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-EnableTaskSequence
Indique si ce programme peut être installé à partir de l’étape de séquence de tâches Installer le package .
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| 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 |
-GenerateMomAlertOnFail
Indique si Configuration Manager génère une entrée d’événement du journal des applications en cas d’échec du programme.
| Type: | Boolean |
| 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 programme à configurer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMProgram .
| Type: | IResultObject |
| Alias: | ProgramPackage, Package, Program |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-PackageId
Spécifiez un ID de package avec le programme à configurer.
| Type: | String |
| Alias: | Id |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PackageName
Spécifiez un nom de package avec le programme à configurer.
| Type: | String |
| Alias: | Name |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PassThru
Renvoie un objet représentant 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 |
-ProgramAssignedType
Spécifiez si le programme s’exécute une fois sur l’ordinateur ou une fois pour chaque utilisateur qui se connecte à l’ordinateur. La valeur par défaut est RunOnceForTheComputer. Le programme est affecté uniquement aux utilisateurs lorsque le paramètre ProgramRunType a la valeur OnlyWhenUserIsLoggedOn.
| Type: | ProgramAssignedType |
| Valeurs acceptées: | RunOnceForTheComputer, RunOnceForEveryUserWhoLogsOn |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ProgramName
Spécifiez le nom du programme à configurer.
| Type: | String |
| Alias: | StandardProgramName, DeviceProgramName |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ProgramRunType
Spécifiez les conditions d’ouverture de session nécessaires à l’exécution du programme. La valeur par défaut est OnlyWhenUserIsLoggedOn.
| Type: | ProgramRunType |
| Valeurs acceptées: | OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Reconnect
Indique si l’ordinateur client se reconnecte au point de distribution lorsque l’utilisateur se connecte.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RemoveSupportedOperatingSystemPlatform
Spécifiez une ou plusieurs plateformes de système d’exploitation prises en charge à supprimer pour le programme. Pour obtenir cet objet, utilisez l’applet de commande Get-CMSupportedPlatform .
| Type: | IResultObject[] |
| Alias: | RemoveSupportedOperatingSystemPlatforms |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Requirement
Spécifiez toutes les exigences supplémentaires pour les programmes standard ou d’appareil.
| 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 |
-RunMode
Spécifiez les informations d’identification dont l’ordinateur client a besoin pour exécuter le programme.
| Type: | RunModeType |
| Valeurs acceptées: | RunWithUserRights, RunWithAdministrativeRights |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RunOnAnyPlatform
Ajoutez ce paramètre pour effacer toutes les plateformes de système d’exploitation prises en charge de ce programme.
| Type: | SwitchParameter |
| Alias: | ClearSupportedOperatingSystemPlatforms |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RunType
Spécifiez le mode dans lequel le programme s’exécute sur l’ordinateur client. La valeur par défaut est Normal.
| Type: | RunType |
| Valeurs acceptées: | Normal, Minimized, Maximized, Hidden |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-StandardProgram
Indique que le type de programme dans le package de déploiement est un programme standard.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SuppressProgramNotification
Définissez ce paramètre sur $true pour supprimer les notifications de programme.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-UserInteraction
Indique s’il faut autoriser les utilisateurs à interagir avec le programme.
| Type: | Boolean |
| 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: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WorkingDirectory
Spécifiez un répertoire de travail pour le programme.
| 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 |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
System.Object