Set-CMApplicationGroup

Module:

ConfigurationManager

Configurez un groupe d’applications existant.

Syntax

Set-CMApplicationGroup
   [-InputObject] <IResultObject>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   [-Id] <Int32>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   -ModelName <String>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   [-Name] <String>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette cmdlet pour configurer les paramètres d’un groupe d’applications existant. 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.

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 : renommer un groupe d’applications

Cet exemple obtient un objet pour le groupe d’applications et le transmet à cette cmdlet pour le renommer.

$appgroup = Get-CMApplicationGroup -Name "Central app"
Set-CMApplicationGroup -InputObject $appgroup -NewName "Contoso Central App"

Exemple 2 : Ajouter un nom localisée

Cet exemple configure le groupe d’applications avec un nom d’application localisée pour l’Irlande.

Set-CMApplicationGroup -Name "Contoso Welcome app" -ApplyToLanguageById 60 -LocalizedName "Fáilte romhat"

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

-AddAppCatalog

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

-AddAppCategory

Spécifiez un ou plusieurs objets de catégorie d’administration pour vous aider à filtrer et trouver le groupe d’applications dans la console. Pour obtenir ces objets, utilisez la cmdlet Get-CMCategory. Ces catégories sont de type AppCategories.

Pour ajouter des catégories pour aider les utilisateurs à filtrer et rechercher des applications dans le Centre de logiciels, utilisez le paramètre AddUserCategory.

Type:	IResultObject[]
Aliases:	AddAppCategories
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

-AddUserCategory

Spécifiez un ou plusieurs objets de catégorie d’utilisateur pour vous aider à filtrer et trouver le groupe d’applications dans la console. Pour obtenir ces objets, utilisez la cmdlet Get-CMCategory. Ces catégories sont de type CatalogCategories.

Pour ajouter des catégories pour aider les utilisateurs à filtrer et rechercher des applications dans le Centre de logiciels, utilisez le paramètre AddAppCategory.

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

-ApplyToLanguageById

Pour les paramètres qui s’affichent dans le Centre de logiciels, utilisez ce paramètre pour spécifier l’ID de langue pour les paramètres.

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.

Par exemple, pour ajouter un nom d’application localisée pour l’Irlande (Irlande):

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

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

-CleanAppCategory

Ajoutez ce paramètre pour supprimer toutes les catégories administratives. Pour supprimer une catégorie unique, utilisez le paramètre RemoveAppCategory.

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

-CleanUserCategory

Ajoutez ce paramètre pour supprimer toutes les catégories d’utilisateurs. Pour supprimer une catégorie unique, utilisez le paramètre RemoveUserCategory.

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

-ClearAppCatalog

Ajoutez ce paramètre pour supprimer toutes les entrées localisées du Centre de logiciels. Pour supprimer une seule entrée, utilisez le paramètre RemoveAppCatalog.

Type:	SwitchParameter
Aliases:	ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearOwner

Ajoutez ce paramètre pour supprimer tous les propriétaires. Pour supprimer un seul propriétaire, utilisez le paramètre RemoveOwner.

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

-ClearSupportContact

Ajoutez ce paramètre pour supprimer tous les contacts de support. Pour supprimer un seul contact, utilisez le paramètre RemoveSupportContact.

Type:	SwitchParameter
Aliases:	CleanSupportContacts
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

-Id

Spécifiez l’ID du groupe d’applications à configurer. Cette valeur est identique à la CI_ID, par exemple 1025866 .

Type:	Int32
Aliases:	CIId, CI_ID
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Spécifiez un objet groupe d’applications à configurer. Pour obtenir cet objet, utilisez l’cmdlet Get-CMApplicationGroup.

Type:	IResultObject
Aliases:	ApplicationGroup
Position:	0
Default value:	None
Accept pipeline input:	True
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

-ModelName

Spécifiez l’identificateur de modèle d’application du groupe d’applications à configurer. Cette valeur est également connue sous le nom d’ID unique CI. Par exemple, ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed.

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

-Name

Spécifiez le nom du groupe d’applications à configurer.

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

-NewName

Utilisez ce paramètre pour renommer le groupe d’applications. La longueur maximale est de 256caractères.

Type:	String
Position:	Named
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

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette cmdlet peut ne pas générer de sortie.

Type:	SwitchParameter
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

-RemoveAppCatalog

Spécifiez un tableau d’ID de langue pour supprimer les entrées du Centre de logiciels associées. Pour supprimer toutes les entrées, utilisez le paramètre ClearAppCatalog.

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.

Par exemple, pour supprimer l’entrée localisée du Centre de logiciels pour l’Irlande (Irlande):

-RemoveAppCatalog 2108

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

-RemoveAppCategoryName

Spécifiez un tableau de noms de catégories d’administration à supprimer. Pour supprimer toutes les catégories administratives, utilisez le paramètre CleanAppCategory.

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

-RemoveApplication

Spécifiez un tableau de noms d’applications à supprimer de ce groupe.

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

-RemoveOwner

Spécifiez un tableau de propriétaires à supprimer. Pour supprimer tous les propriétaires, utilisez le paramètre ClearOwner.

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

-RemoveSupportContact

Spécifiez un tableau de contacts de support à supprimer. Pour supprimer tous les contacts de support, utilisez le paramètre ClearSupportContact.

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

-RemoveUserCategoryName

Spécifiez un tableau de noms de catégorie d’utilisateurs à supprimer. Pour supprimer toutes les catégories d’utilisateurs, utilisez le paramètre CleanUserCategory.

Type:	String[]
Aliases:	RemoveUserCategoryNames
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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject

Cette cmdlet renvoie l’SMS_ApplicationGroup de classe WMI.

Liens associés

• Get-CMApplicationGroup
• New-CMApplicationGroup
• Remove-CMApplicationGroup
• New-CMApplicationDisplayInfo
• Get-CMApplicationGroupDeployment
• New-CMApplicationGroupDeployment
• Remove-CMApplicationGroupDeployment
• Set-CMApplicationGroupDeployment
• Créer des groupes d’applications