New-CMApplication
Créez une application.
Syntaxe
New-CMApplication
[-AddOwner <String[]>]
[-AddSupportContact <String[]>]
[-AppCatalog <AppDisplayInfo[]>]
[-AutoInstall <Boolean>]
[-DefaultLanguageId <Int32>]
[-Description <String>]
[-DisplaySupersedenceInApplicationCatalog <Boolean>]
[-IconLocationFile <String>]
[-IsFeatured <Boolean>]
[-Keyword <String[]>]
[-LinkText <String>]
[-LocalizedDescription <String>]
[-LocalizedName <String>]
[-Name] <String>
[-OptionalReference <String>]
[-Owner <String>]
[-PrivacyUrl <String>]
[-Publisher <String>]
[-ReleaseDate <DateTime>]
[-SoftwareVersion <String>]
[-SupportContact <String>]
[-UserDocumentation <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Utilisez cette applet de commande pour créer une application. Une application Configuration Manager définit les métadonnées relatives à l’application. Pour plus d’informations, consultez Créer des applications 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 une application
Cette commande crée une application nommée Application01.
New-CMApplication -Name "Application01" -Description "New Application" -Publisher "Contoso" -SoftwareVersion "1.0.0.1" -OptionalReference "Reference" -ReleaseDate 2/24/2016 -AutoInstall $True -Owner "Administrator" -SupportContact "Administrator" -LocalizedName "Application01" -UserDocumentation "https://contoso.com/content" -LinkText "For more information" -LocalizedDescription "New Localized Application" -Keyword "application" -PrivacyUrl "https://contoso.com/library/privacy" -IsFeatured $True -IconLocationFile "\\central\icons\icon.png"Paramètres
-AddOwner
Spécifiez un ou plusieurs utilisateurs administratifs responsables de cette application.
| Type: | String[] |
| Alias: | AddOwners |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AddSupportContact
Spécifiez un ou plusieurs utilisateurs administratifs que les utilisateurs finaux peuvent contacter pour obtenir de l’aide sur cette application.
| Type: | String[] |
| Alias: | AddSupportContacts |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AppCatalog
Utilisez ce paramètre pour spécifier une entrée du Centre logiciel pour une langue spécifique. Cette entrée peut inclure toutes les informations localisées sur l’application :
- Description
- IconLocationFile
- Mot clé
- LinkText
- PrivacyUrl
- Titre
- UserDocumentation
Pour obtenir cet objet, utilisez l’applet de commande New-CMApplicationDisplayInfo .
| Type: | AppDisplayInfo[] |
| Alias: | AppCatalogs |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AutoInstall
Définissez ce paramètre sur $true pour permettre l’installation de l’application à partir de l’étape de séquence de tâches Installer l’application sans être déployée.
| 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 |
-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 |
-DefaultLanguageId
Spécifiez l’ID de langue pour la langue par défaut du Centre logiciel.
Cet ID est l’équivalent décimal de l’ID de langue Windows. Par exemple, 1033 est 0x0409 destiné à l’anglais (États-Unis) et 2108 à l’irlandais 0x083C(Irlande). Pour plus d’informations, consultez [MS-LCID] : Référence LCID (Windows Language Code Identifier).
| 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 |
-Description
Spécifiez un commentaire administrateur facultatif pour l’application. La longueur maximale est de 2 048 caractères.
| 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 |
-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 |
-DisplaySupersedenceInApplicationCatalog
N’utilisez pas ce paramètre. Le catalogue d’applications n’est plus pris en charge.
| Type: | Boolean |
| Alias: | DisplaySupersedencesInApplicationCatalog |
| 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 |
-IconLocationFile
Spécifiez le chemin d’accès au fichier qui contient l’icône de cette application. Les icônes peuvent avoir des dimensions en pixels allant jusqu’à 512 x 512. Le fichier peut être des types de fichiers d’image et d’icône suivants :
- DLL
- EXE
- JPG
- ICO
- PNG
| 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 |
-IsFeatured
Définissez ce paramètre sur $true pour afficher cette application en tant qu’application proposée et la mettre en surbrillance dans le portail d’entreprise.
| 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 |
-Keyword
Spécifiez une liste de mots clés dans la langue sélectionnée. Ces mots clés aident les utilisateurs du Centre logiciel à rechercher l’application.
Conseil
Pour ajouter plusieurs mots clés, utilisez CultureInfo.CurrentCulture.TextInfo.ListSeparator comme délimiteur.
| Type: | String[] |
| Alias: | Keywords |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-LinkText
Lorsque vous utilisez le paramètre UserDocumentation , utilisez ce paramètre pour afficher une chaîne à la place de « Informations supplémentaires » dans le Centre logiciel. La longueur maximale est de 128 caractères.
| 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 |
-LocalizedDescription
Spécifiez une description pour cette application dans la langue sélectionnée. La longueur maximale est de 2 048 caractères.
| Type: | String |
| Alias: | LocalizedApplicationDescription |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-LocalizedName
Spécifiez le nom de l’application dans la langue sélectionnée. Ce nom apparaît dans le Centre logiciel.
Un nom est requis pour chaque langue que vous ajoutez.
La longueur maximale est de 256 caractères.
| Type: | String |
| Alias: | LocalizedApplicationName |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Name
Spécifiez un nom pour l’application. La longueur maximale est de 256 caractères.
| Type: | String |
| Alias: | LocalizedDisplayName |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-OptionalReference
Spécifiez une chaîne facultative pour vous aider à trouver l’application dans la console. La longueur maximale est de 256 caractères.
| 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 |
-Owner
Spécifiez un utilisateur administratif responsable de cette application.
| 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 |
-PrivacyUrl
Spécifiez une adresse de site web pour la déclaration de confidentialité de l’application. Le format doit être une URL valide, par exemple https://contoso.com/privacy. La longueur maximale de la chaîne entière est de 128 caractères.
| 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 |
-Publisher
Spécifiez des informations de fournisseur facultatives pour cette application. La longueur maximale est de 256 caractères.
| Type: | String |
| Alias: | Manufacturer |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ReleaseDate
Spécifiez un objet date pour la date de publication de cette application. Pour obtenir cet objet, utilisez l’applet de commande intégrée Get-Date .
| Type: | DateTime |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SoftwareVersion
Spécifiez une chaîne de version facultative pour l’application. La longueur maximale est de 64 caractères.
| 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 |
-SupportContact
Spécifiez un utilisateur administratif que les utilisateurs finaux peuvent contacter pour obtenir de l’aide sur cette application.
| 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 |
-UserDocumentation
Spécifiez l’emplacement d’un fichier à partir duquel les utilisateurs du Centre logiciel peuvent obtenir plus d’informations sur cette application. Cet emplacement est une adresse de site web ou un chemin d’accès réseau et un nom de fichier. Assurez-vous que les utilisateurs ont accès à cet emplacement.
La longueur maximale de la chaîne entière est de 256 caractères.
| 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 |
-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 |
Entrées
None
Sorties
IResultObject
IResultObject
Notes
Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_Application classe WMI du serveur.