Delen via

New-CMApplicationGroup

  • Artikel

SYNOPSIS

Maak een nieuwe toepassingsgroep.

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

Gebruik deze cmdlet om een toepassingsgroep te maken. Gebruik een toepassingsgroep 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 bestellen, zodat de client deze in een specifieke volgorde installeert. Zie Toepassingsgroepen maken voor meer informatie.

Er zijn enkele instellingen van een app-groep die u niet kunt configureren wanneer u deze maakt. Gebruik de cmdlet Set-CMApplicationGroup om andere instellingen te configureren.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een groep met twee apps maken

In dit voorbeeld wordt een nieuwe app-groep met de naam Central-app gemaakt die twee apps bevat.

$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'

PARAMETERS

-AddApplication

Geef een tekenreeksmatrice 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: True
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

-AppGroupCatalog

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

-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

-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

-Name

Geef een naam op voor de app-groep. De maximale lengte is 256 tekens.

Type: String
Parameter Sets: (All)
Aliases: LocalizedDisplayName, ApplicationGroupName

Required: True
Position: 0
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

-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

-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

Geen

OUTPUTS

IResultObject#SMS_ApplicationGroup

OPMERKINGEN

Deze cmdlet retourneert de SMS_ApplicationGroup WMI-klasseobject.

Get-CMApplicationGroup Remove-CMApplicationGroup Set-CMApplicationGroup

New-CMApplicationDisplayInfo

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

Toepassingsgroepen maken