New-CMProgram
Créez un programme pour un package.
Syntax
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 Configuration Manager applets de commande à 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[] |
Aliases: | AddSupportedOperatingSystemPlatforms |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CommandLine
Spécifiez la ligne de commande du programme.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeviceProgramName
Spécifie un nom de programme d’appareil.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | DiskSpaceReq |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskSpaceUnit
Spécifiez une unité acceptée pour le paramètre DiskSpaceRequirement .
Type: | DiskSpaceUnitType |
Accepted values: | KB, MB, GB |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DownloadProgramType
Spécifiez quand le programme doit s’exécuter.
Type: | DownloadProgramType |
Accepted values: | AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriveLetter
Si vous utilisez le paramètre DriveMode , spécifiez une lettre de lecteur pour l’emplacement.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accepted values: | RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageId
Spécifiez l’ID du package pour ce programme.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageName
Spécifiez un nom de package pour ce programme.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accepted values: | OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Reconnect
Indique si l’ordinateur client se reconnecte au point de distribution lorsque l’utilisateur se connecte à Windows.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Requirement
Spécifie des exigences supplémentaires pour les programmes standard ou d’appareil.
Type: | String |
Aliases: | Requirements |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunMode
Spécifiez les informations d’identification dont le programme a besoin pour s’exécuter sur l’ordinateur client.
Type: | RunModeType |
Accepted values: | RunWithUserRights, RunWithAdministrativeRights |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Accepted values: | Normal, Minimized, Maximized, Hidden |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StandardProgramName
Spécifiez le nom du programme standard.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserInteraction
Indique s’il faut autoriser les utilisateurs à interagir avec le programme.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkingDirectory
Spécifiez un répertoire de travail pour le programme.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour