Dela via

New-CMApplicationGroup

  • Artikel

SYNOPSIS

Skapa en ny programgrupp.

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

Använd den här cmdleten för att skapa en programgrupp. Använd en programgrupp för att distribuera flera program till en samling som en enda distribution. De metadata som du anger om appgruppen visas i Software Center som en enda entitet. Du kan beställa apparna i gruppen så att klienten installerar dem i en viss ordning. Mer information finns i Skapa programgrupper.

Det finns vissa inställningar för en appgrupp som du inte kan konfigurera när du skapar den. Om du vill konfigurera andra inställningar använder du cmdleten Set-CMApplicationGroup.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Skapa en grupp med två appar

I det här exemplet skapas en ny appgrupp med namnet Central-app som innehåller två appar.

$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

Ange en strängmatris med appnamn som ska läggas till i gruppen. Om du redan har ett appobjekt från en annan cmdlet som Get-CMApplicationär det här värdet egenskapen LocalizedDisplayName. Exempelvis: $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

Ange en eller flera administrativa användare som ansvarar för den här appgruppen.

Type: String[]
Parameter Sets: (All)
Aliases: AddOwners

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

-AddSupportContact

Ange en eller flera administrativa användare som slutanvändarna kan kontakta för att få hjälp med det här programmet.

Type: String[]
Parameter Sets: (All)
Aliases: AddSupportContacts

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

-AppGroupCatalog

Använd den här parametern för att ange en Software Center-post för ett visst språk. Den här posten kan innehålla all lokaliserad information om appgruppen:

  • Description
  • IconLocationFile
  • Sökord
  • LinkText
  • PrivacyUrl
  • Rubrik
  • UserDocumentation

Hämta det här objektet med cmdleten New-CMApplicationDisplayInfo.

Type: AppDisplayInfo[]
Parameter Sets: (All)
Aliases: AppCatalogs

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DefaultLanguageId

Ange språk-ID:t för standardspråket i Software Center.

Det här ID:t motsvarar decimaltecknet för Windows språk-ID. Till exempel 1033 är för engelska 0x0409 (USA) och 2108 är för England 0x083C (Irland). Mer information finns i [MS-LCID]: Windows LCID-referens (Language Code Identifier).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Beskrivning

Ange en valfri administratörskommentar för appgruppen. Den maximala längden är 2 048 tecken.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-IconLocationFile

Ange sökvägen till filen som innehåller ikonen för den här appgruppen. Ikoner kan ha pixeldimensioner på upp till 512 x 512. Filen kan vara av följande bild- och ikonfiltyper:

  • 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

-Nyckelord

Ange en lista med nyckelord på det valda språket. Dessa nyckelord hjälper Software Center-användare att söka efter appgruppen.

Tips

Om du vill lägga till flera nyckelord använder du CultureInfo.CurrentCulture.TextInfo.ListSeparator som avgränsare.

Type: String[]
Parameter Sets: (All)
Aliases: Keywords

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

-LinkText

När du använder parametern UserDocumentation använder du den här parametern för att visa en sträng i stället för "Ytterligare information" i Software Center. Den maximala längden är 128 tecken.

Type: String
Parameter Sets: (All)
Aliases:

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

-LocalizedDescription

Ange en beskrivning för den här appgruppen på det valda språket. Den maximala längden är 2 048 tecken.

Type: String
Parameter Sets: (All)
Aliases: LocalizedAppGroupDescription

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

-LocalizedName

Ange appgruppens namn på det valda språket. Det här namnet visas i Software Center.

Ett namn krävs för varje språk som du lägger till.

Den maximala längden är 256 tecken.

Type: String
Parameter Sets: (All)
Aliases: LocalizedAppGroupName

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

-Name

Ange ett namn för appgruppen. Den maximala längden är 256 tecken.

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

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OptionalReference

Ange en valfri sträng som hjälper dig att hitta appgruppen i konsolen. Den maximala längden är 256 tecken.

Type: String
Parameter Sets: (All)
Aliases:

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

-PrivacyUrl

Ange en webbplatsadress till sekretesspolicyn för appgruppen. Formatet måste vara en giltig URL, till exempel https://contoso.com/privacy . Den maximala längden för hela strängen är 128 tecken.

Type: String
Parameter Sets: (All)
Aliases:

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

-Publisher

Ange valfri leverantörsinformation för den här appgruppen. Den maximala längden är 256 tecken.

Type: String
Parameter Sets: (All)
Aliases: Manufacturer

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

-ReleaseDate

Ange ett datumobjekt för när den här appgruppen släpptes. Hämta det här objektet med hjälp av den inbyggda cmdleten Get-Date.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-SoftwareVersion

Ange en valfri versionssträng för appgruppen. Den maximala längden är 64 tecken.

Type: String
Parameter Sets: (All)
Aliases:

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

-UserDocumentation

Ange platsen för en fil från vilken Software Center-användare kan få mer information om den här appgruppen. Den här platsen är en webbplatsadress eller en nätverkssökväg och ett filnamn. Kontrollera att användarna har åtkomst till den här platsen.

Den maximala längden för hela strängen är 256 tecken.

Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Ingen

OUTPUTS

IResultObject#SMS_ApplicationGroup

ANTECKNINGAR

Den här cmdleten returnerar SMS_ApplicationGroup WMI-klassobjektet.

Get-CMApplicationGroup Remove-CMApplicationGroup Set-CMApplicationGroup

New-CMApplicationDisplayInfo

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

Skapa programgrupper