Set-CMApplicationGroup
SYNOPSIS
Configureer een bestaande toepassingsgroep.
SYNTAX
SetByValue (standaard)
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>]
SetById
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>]
SetByModelName
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>]
SetByName
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
Gebruik deze cmdlet om de instellingen van een bestaande toepassingsgroep te configureren. Gebruik een app-groep om meerdere toepassingen als één implementatie te implementeren in een verzameling. De metagegevens die u opgeeft over de app-groep worden in Software Center gezien als één entiteit. U kunt de apps in de groep orden, zodat de client ze in een specifieke volgorde installeert. Zie Toepassingsgroepen maken voor meer informatie.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\>
. Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: De naam van een app-groep wijzigen
In dit voorbeeld wordt een -object voor de app-groep opgeslagen en aan deze cmdlet door geven om de naam ervan te wijzigen.
$appgroup = Get-CMApplicationGroup -Name "Central app"
Set-CMApplicationGroup -InputObject $appgroup -NewName "Contoso Central App"
Voorbeeld 2: Een gelokaliseerde naam toevoegen
In dit voorbeeld configureert u de app-groep met een gelokaliseerde app-naam voor de taal Talen.
Set-CMApplicationGroup -Name "Contoso Welcome app" -ApplyToLanguageById 60 -LocalizedName "Fáilte romhat"
PARAMETERS
-AddAppCatalog
Gebruik deze parameter om een Software Center-vermelding voor een specifieke taal op te geven. Deze vermelding kan alle gelokaliseerde informatie over de app-groep bevatten:
- Description
- IconLocationFile
- Trefwoord
- LinkText
- PrivacyUrl
- Titel
- UserDocumentation
Gebruik de cmdlet New-CMApplicationDisplayInfo om dit object op te halen.
Type: AppDisplayInfo[]
Parameter Sets: (All)
Aliases: AppCatalogs
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AddAppCategory
Geef een of meer beheercategorieobjecten op om de app-groep te filteren en te zoeken in de console. Gebruik de cmdlet Get-CMCategory om deze objecten op te halen. Deze categorieën zijn van het type AppCategories.
Als u categorieën wilt toevoegen om gebruikers te helpen bij het filteren en vinden van toepassingen in Software Center, gebruikt u de parameter AddUserCategory.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddAppCategories
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AddApplication
Geef een tekenreeks matrix met app-namen op die u aan de groep wilt toevoegen. Als u al een app-object van een andere cmdlet hebt, zoals Get-CMApplication,is deze waarde de eigenschap LocalizedDisplayName. Bijvoorbeeld: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)
Type: String[]
Parameter Sets: (All)
Aliases: AddApplications
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AddOwner
Geef een of meer beheerders op die verantwoordelijk zijn voor deze app-groep.
Type: String[]
Parameter Sets: (All)
Aliases: AddOwners
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AddSupportContact
Geef een of meer gebruikers met beheerders beheerderskosten op die eindgebruikers kunnen gebruiken voor hulp bij deze toepassing.
Type: String[]
Parameter Sets: (All)
Aliases: AddSupportContacts
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AddUserCategory
Geef een of meer gebruikerscategorieobjecten op om de app-groep te filteren en te zoeken in de console. Gebruik de cmdlet Get-CMCategory om deze objecten op te halen. Deze categorieën zijn van het type CatalogCategories.
Als u categorieën wilt toevoegen om gebruikers te helpen bij het filteren en vinden van toepassingen in Software Center, gebruikt u de parameter AddAppCategory.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddUserCategories
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ApplyToLanguageById
Gebruik deze parameter voor instellingen die worden weergegeven in Software Center om de taal-id voor de instellingen op te geven.
Deze id is het decimale equivalent van de Windows taal-id. is bijvoorbeeld 1033
voor 0x0409
Engels (Verenigde Staten) en 2108
is voor Moet 0x083C
(Ierland). Zie [MS-LCID]: Windows Language Code Identifier (LCID)-verwijzing voor meer informatie.
Als u bijvoorbeeld een gelokaliseerde app-naam voor Moet (Ierland) wilt toevoegen:
-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"
Type: Int32
Parameter Sets: (All)
Aliases: ApplySettingToSpecificLanguage
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CleanAppCategory
Voeg deze parameter toe om alle beheercategorieën te verwijderen. Als u één categorie wilt verwijderen, gebruikt u de parameter RemoveAppCategory.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: CleanAppCategories
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CleanUserCategory
Voeg deze parameter toe om alle gebruikerscategorieën te verwijderen. Als u één categorie wilt verwijderen, gebruikt u de parameter RemoveUserCategory.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: CleanUserCategories
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ClearAppCatalog
Voeg deze parameter toe om alle gelokaliseerde Software Center-vermeldingen te verwijderen. Als u één vermelding wilt verwijderen, gebruikt u de parameter RemoveAppCatalog.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ClearOwner
Voeg deze parameter toe om alle eigenaren te verwijderen. Als u één eigenaar wilt verwijderen, gebruikt u de parameter RemoveOwner.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: CleanOwners
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ClearSupportContact
Voeg deze parameter toe om alle contactpersonen voor ondersteuning te verwijderen. Als u één contactpersoon wilt verwijderen, gebruikt u de parameter RemoveSupportContact.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: CleanSupportContacts
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DefaultLanguageId
Geef de taal-id op voor de standaardtaal van Software Center.
Deze id is het decimale equivalent van de Windows taal-id. is bijvoorbeeld 1033
voor 0x0409
Engels (Verenigde Staten) en 2108
is voor Moet 0x083C
(Ierland). Zie [MS-LCID]: Windows Language Code Identifier (LCID)-verwijzing voor meer informatie.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Beschrijving
Geef een optionele opmerking van de beheerder op voor de app-groep. De maximale lengte is 2048 tekens.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IconLocationFile
Geef het pad op naar het bestand dat het pictogram voor deze app-groep bevat. Pictogrammen kunnen pixelgrootten hebben van maximaal 512x512. Het bestand kan van de volgende afbeeldings- en pictogrambestandstypen zijn:
- Dll
- Exe
- JPG
- Ico
- PNG
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Geef de id op van de app-groep die u wilt configureren. Deze waarde is hetzelfde als de CI_ID, bijvoorbeeld 1025866
.
Type: Int32
Parameter Sets: SetById
Aliases: CIId, CI_ID
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Geef een app-groepsobject op dat u wilt configureren. Gebruik de cmdlet Get-CMApplicationGroup om dit object op te halen.
Type: IResultObject
Parameter Sets: SetByValue
Aliases: ApplicationGroup
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Sleutelwoord
Geef een lijst met trefwoorden op in de geselecteerde taal. Met deze trefwoorden kunnen Software Center-gebruikers zoeken naar de app-groep.
Tip
Als u meerdere trefwoorden wilt toevoegen, gebruikt u CultureInfo.CurrentCulture.TextInfo.ListSeparator als scheidingsteken.
Type: String[]
Parameter Sets: (All)
Aliases: Keywords
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LinkText
Wanneer u de parameter UserDocumentation gebruikt, gebruikt u deze parameter om een tekenreeks weer te geven in plaats van 'Aanvullende informatie' in Software Center. De maximale lengte is 128 tekens.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LocalizedDescription
Geef een beschrijving op voor deze app-groep in de geselecteerde taal. De maximale lengte is 2048 tekens.
Type: String
Parameter Sets: (All)
Aliases: LocalizedAppGroupDescription
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LocalizedName
Geef de naam van de app-groep op in de geselecteerde taal. Deze naam wordt weergegeven in Software Center.
Er is een naam vereist voor elke taal die u toevoegt.
De maximale lengte is 256 tekens.
Type: String
Parameter Sets: (All)
Aliases: LocalizedAppGroupName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ModelName
Geef de id van het toepassingsmodel op van de app-groep die u wilt configureren. Deze waarde wordt ook wel de unieke CI-id genoemd. Bijvoorbeeld ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed
.
Type: String
Parameter Sets: SetByModelName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Geef de naam op van de app-groep die u wilt configureren.
Type: String
Parameter Sets: SetByName
Aliases: LocalizedDisplayName, ApplicationGroupName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Gebruik deze parameter om de naam van de app-groep te wijzigen. De maximale lengte is 256 tekens.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OptionalReference
Geef een optionele tekenreeks op om de app-groep in de console te vinden. De maximale lengte is 256 tekens.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Voeg deze parameter toe om een object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrivacyUrl
Geef een websiteadres op voor de privacyverklaring voor de app-groep. De indeling moet een geldige URL zijn, bijvoorbeeld https://contoso.com/privacy
. De maximale lengte van de hele tekenreeks is 128 tekens.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Publisher
Geef optionele leveranciergegevens op voor deze app-groep. De maximale lengte is 256 tekens.
Type: String
Parameter Sets: (All)
Aliases: Manufacturer
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ReleaseDate
Geef een datumobject op voor wanneer deze app-groep is vrijgegeven. Gebruik de ingebouwde cmdlet Get-Date om dit object op te halen.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveAppCatalog
Geef een matrix met taal-ID's op om de bijbehorende Software Center-vermeldingen te verwijderen. Als u alle vermeldingen wilt verwijderen, gebruikt u de parameter ClearAppCatalog.
Deze id is het decimale equivalent van de Windows taal-id. is bijvoorbeeld 1033
voor 0x0409
Engels (Verenigde Staten) en 2108
is voor Moet 0x083C
(Ierland). Zie [MS-LCID]: Windows Language Code Identifier (LCID)-verwijzing voor meer informatie.
Als u bijvoorbeeld de gelokaliseerde Vermelding van Software Center voor Ierland (Ierland) wilt verwijderen:
-RemoveAppCatalog 2108
Type: Int32[]
Parameter Sets: (All)
Aliases: RemoveAppCatalogsByLanguageId
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveAppCategoryName
Geef een matrix met namen van beheerderscategorie op die moeten worden verwijderd. Als u alle beheercategorieën wilt verwijderen, gebruikt u de parameter CleanAppCategory.
Type: String[]
Parameter Sets: (All)
Aliases: RemoveAppCategoryNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveApplication
Geef een matrix met toepassingsnamen op die u uit deze groep wilt verwijderen.
Type: String[]
Parameter Sets: (All)
Aliases: RemoveApplications
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveOwner
Geef een matrix met eigenaren op die u wilt verwijderen. Als u alle eigenaren wilt verwijderen, gebruikt u de parameter ClearOwner.
Type: String[]
Parameter Sets: (All)
Aliases: RemoveOwners
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveSupportContact
Geef een matrix met ondersteuningscontacten op die u wilt verwijderen. Als u alle contactpersonen voor ondersteuning wilt verwijderen, gebruikt u de parameter ClearSupportContact.
Type: String[]
Parameter Sets: (All)
Aliases: RemoveSupportContacts
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveUserCategoryName
Geef een matrix met gebruikerscategorienamen op die u wilt verwijderen. Als u alle gebruikerscategorieën wilt verwijderen, gebruikt u de parameter CleanUserCategory.
Type: String[]
Parameter Sets: (All)
Aliases: RemoveUserCategoryNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SoftwareVersion
Geef een optionele versiereeks op voor de app-groep. De maximale lengte is 64 tekens.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserDocumentation
Geef de locatie op van een bestand van waaruit Software Center-gebruikers meer informatie over deze app-groep kunnen krijgen. Deze locatie is een websiteadres of een netwerkpad en bestandsnaam. Zorg ervoor dat gebruikers toegang hebben tot deze locatie.
De maximale lengte van de hele tekenreeks is 256 tekens.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject#SMS_ApplicationGroup
Deze cmdlet retourneert de SMS_ApplicationGroup WMI-klasseobject.
OPMERKINGEN
RELATED LINKS
Get-CMApplicationGroup New-CMApplicationGroup Remove-CMApplicationGroup
Get-CMApplicationGroupDeployment New-CMApplicationGroupDeployment Remove-CMApplicationGroupDeployment Set-CMApplicationGroupDeployment