New-CMApplicationGroup
Créez un groupe d’applications.
Syntax
New-CMApplicationGroup
[-Name] <String>
-AddApplication <String[]>
[-Description <String>]
[-Publisher <String>]
[-SoftwareVersion <String>]
[-OptionalReference <String>]
[-ReleaseDate <DateTime>]
[-AddOwner <String[]>]
[-AddSupportContact <String[]>]
[-AppGroupCatalog <AppDisplayInfo[]>]
[-DefaultLanguageId <Int32>]
[-LocalizedName <String>]
[-UserDocumentation <String>]
[-LinkText <String>]
[-PrivacyUrl <String>]
[-LocalizedDescription <String>]
[-Keyword <String[]>]
[-IconLocationFile <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Utilisez cette cmdlet pour créer un groupe d’applications. Utilisez un groupe d’applications pour déployer plusieurs applications dans une collection en tant que déploiement unique. Les métadonnées que vous spécifiez sur le groupe d’applications sont considérées dans le Centre de logiciels comme une seule entité. Vous pouvez commander les applications du groupe afin que le client les installe dans un ordre spécifique. Pour plus d’informations, voir Créer des groupes d’applications.
Certains paramètres d’un groupe d’applications ne peuvent pas être configurés lorsque vous le créez. Pour configurer d’autres paramètres, utilisez la cmdlet Set-CMApplicationGroup.
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 un groupe avec deux applications
Cet exemple crée un groupe d’applications nommé Application centrale qui inclut deux applications.
$apps = @('LOB Framework','CA UI')
New-CMApplicationGroup -Name 'Central app' -AddApplication $apps -Description 'Central app group' -Publisher 'Contoso IT' -SoftwareVersion '1.1.2' -ReleaseDate (Get-Date) -AddOwner 'jqpublic' -AddSupportContact 'jdoe' -LocalizedAppGroupName 'Central app'
Paramètres
- Confirmer
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
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: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddApplication
Spécifiez un tableau de chaînes de noms d’application à ajouter au groupe. Si vous avez déjà un objet d’application à partir d’une autre cmdlet comme Get-CMApplication, cette valeur est la propriété LocalizedDisplayName. Par exemple : $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)
Type: | String[] |
Aliases: | AddApplications |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddOwner
Spécifiez un ou plusieurs utilisateurs administratifs responsables de ce groupe d’applications.
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 |
-AppGroupCatalog
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 le groupe d’applications :
- 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 |
-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 le groupe d’applications. 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 |
-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 ce groupe d’applications. 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 |
-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 le groupe d’applications.
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 ce groupe d’applications dans la langue sélectionnée. La longueur maximale est de 2048caractères.
Type: | String |
Aliases: | LocalizedAppGroupDescription |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalizedName
Spécifiez le nom du groupe d’applications 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: | LocalizedAppGroupName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifiez un nom pour le groupe d’applications. La longueur maximale est de 256caractères.
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationGroupName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OptionalReference
Spécifiez une chaîne facultative pour vous aider à trouver le groupe d’applications 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 |
-PrivacyUrl
Spécifiez une adresse de site web pour la déclaration de confidentialité du groupe d’applications. 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 ce groupe d’applications. 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 de date pour la date de publication de ce groupe d’applications. 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 le groupe d’applications. La longueur maximale est de 64caractères.
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 ce groupe d’applications. 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
Notes
Cette cmdlet renvoie l’SMS_ApplicationGroup de classe WMI.