New-CMProgram

Module:

ConfigurationManager

Créez un programme pour un package.

Syntaxe

New-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   -CommandLine <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   -PackageName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RunMode <RunModeType>]
   [-RunType <RunType>]
   -StandardProgramName <String>
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   -CommandLine <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   -PackageId <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RunMode <RunModeType>]
   [-RunType <RunType>]
   -StandardProgramName <String>
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMProgram
   -CommandLine <String>
   [-CommandLineFolder <String>]
   [-Comment <String>]
   -DeviceProgramName <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMProgram
   -CommandLine <String>
   [-CommandLineFolder <String>]
   [-Comment <String>]
   -DeviceProgramName <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageId <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer un programme pour un package. Les programmes sont des commandes associées à un package Configuration Manager. Ils 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 : Créer un programme

Cet exemple montre comment d’abordplate les paramètres de l’applet de commande dans la variable parameters . Il n’est pas nécessaire de plaquer les paramètres. Cela facilite simplement la lecture des paramètres pour une ligne de commande aussi longue.

Cette commande crée un programme nommé Scan x64 dans le package par défaut de l’outil de migration de l’état utilisateur pour Windows .

$parameters = @{
  PackageName = "User State Migration Tool for Windows"
  StandardProgramName = "Scan x64"
  CommandLine = "amd64\scanstate.exe \\gold\sources$\userdata /i:miguser.xml /i:migapp.xml /o"
  RunType = "Normal"
  ProgramRunType = "OnlyWhenNoUserIsLoggedOn"
  DiskSpaceRequirement = 200
  DiskSpaceUnit = "MB"
  Duration = 100
  DriveMode = "RunWithUnc"
}
New-CMProgram @parameters

Paramè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

-CommandLine

Spécifiez la ligne de commande du programme.

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

-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

-DeviceProgramName

Spécifie un nom de programme d’appareil.

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

-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
Alias:	DiskSpaceReq
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 de RenameWithUnc.

• 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

-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

-PackageId

Spécifiez l’ID du package pour ce programme.

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

-PackageName

Spécifiez un nom de package pour ce programme.

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

-ProgramRunType

Spécifie les conditions d’ouverture de session nécessaires à l’exécution du programme.

Le paramètre 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 à Windows.

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

-Requirement

Spécifie des exigences supplémentaires pour les programmes standard ou d’appareil.

Type:	String
Alias:	Requirements
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 le programme a besoin pour s’exécuter sur l’ordinateur client.

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

-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

-StandardProgramName

Spécifiez le nom du programme standard.

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

-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

None

Sorties

IResultObject

Notes

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

Liens associés

• Disable-CMProgram
• Enable-CMProgram
• Get-CMProgram
• Remove-CMProgram
• Set-CMProgram
• Packages et programmes dans Configuration Manager