Partager via

New-CMApplication

  • Référence
Module:
ConfigurationManager

Créez une application.

Syntax

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 cmdlet pour créer une application. Une application Configuration Manager définit les métadonnées sur l’application. Pour plus d’informations, voir Créer des applications dans Configuration Manager.

Notes

Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\> exemple. Pour plus d’informations, voir la mise en place.

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

- Confirmer

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

- WhatIf

Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-AddOwner

Spécifiez un ou plusieurs utilisateurs administratifs responsables de cette application.

Type:String[]
Aliases:AddOwners
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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[]
Aliases:AddSupportContacts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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’cmdlet New-CMApplicationDisplayInfo.

Type:AppDisplayInfo[]
Aliases:AppCatalogs
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AutoInstall

Définissez ce paramètre sur $true pour permettre à l’application d’être installée à partir de l’étape de séquence de tâches Installer l’application sans être déployée.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DefaultLanguageId

Spécifiez l’ID de langue pour la langue par défaut du Centre de logiciels.

Cet ID est l’équivalent décimal de l’ID Windows langue. Par exemple, 1033 0x0409 s’agit de l’anglais (États-Unis) et de l’irlande 2108 0x083C (Irlande). Pour plus d’informations, voir [MS-LCID]: Windows language Code Identifier (LCID) Reference.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Description

Spécifiez un commentaire administrateur facultatif pour l’application. La longueur maximale est de 2048caractères.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisplaySupersedenceInApplicationCatalog

N’utilisez pas ce paramètre. Le catalogue d’applications n’est plus pris en charge.

Type:Boolean
Aliases:DisplaySupersedencesInApplicationCatalog
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters: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 de pixels 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
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IsFeatured

Définissez ce paramètre sur $true pour afficher cette application en tant qu’application et la mettre en surbrillez dans la Portail d'entreprise.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 de logiciels à rechercher l’application.

Conseil

Pour ajouter plusieurs mots clés, utilisez CultureInfo.CurrentCulture.TextInfo.ListSeparator comme délimiteur.

Type:String[]
Aliases:Keywords
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 de logiciels. La longueur maximale est de 128 caractères.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-LocalizedDescription

Spécifiez une description pour cette application dans la langue sélectionnée. La longueur maximale est de 2048caractères.

Type:String
Aliases:LocalizedApplicationDescription
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-LocalizedName

Spécifiez le nom de l’application dans la langue sélectionnée. Ce nom apparaît dans le Centre de logiciels.

Un nom est requis pour chaque langue que vous ajoutez.

La longueur maximale est de 256caractères.

Type:String
Aliases:LocalizedApplicationName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifiez un nom pour l’application. La longueur maximale est de 256caractères.

Type:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-OptionalReference

Spécifiez une chaîne facultative pour vous aider à trouver l’application dans la console. La longueur maximale est de 256caractères.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Owner

Spécifiez un utilisateur administratif responsable de cette application.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 https://contoso.com/privacy exemple. La longueur maximale de la chaîne entière est de 128 caractères.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Publisher

Spécifiez les informations facultatives du fournisseur pour cette application. La longueur maximale est de 256caractères.

Type:String
Aliases:Manufacturer
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ReleaseDate

Spécifiez un objet date à laquelle cette application a été publiée. Pour obtenir cet objet, utilisez la cmdlet intégrée Get-Date.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareVersion

Spécifiez une chaîne de version facultative pour l’application. La longueur maximale est de 64caractères.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UserDocumentation

Spécifiez l’emplacement d’un fichier à partir duquel les utilisateurs du Centre de logiciels 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
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Néant

Sorties

IResultObject

IResultObject

Notes

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