Set-CMApplicationGroup
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.