Delen via

Set-CMApplicationGroup

  • Artikel

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

Get-CMApplicationGroup New-CMApplicationGroup Remove-CMApplicationGroup

New-CMApplicationDisplayInfo

Get-CMApplicationGroupDeployment New-CMApplicationGroupDeployment Remove-CMApplicationGroupDeployment Set-CMApplicationGroupDeployment

Toepassingsgroepen maken