Dela via

Set-CMApplicationGroup

  • Artikel

SYNOPSIS

Konfigurera en befintlig programgrupp.

SYNTAX

SetByValue (standard)

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

Använd den här cmdleten för att konfigurera inställningarna för en befintlig programgrupp. Använd en appgrupp 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.

Anteckning

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

EXAMPLES

Exempel 1: Byt namn på en appgrupp

Det här exemplet hämtar ett objekt för appgruppen och skickar det till denna cmdlet för att byta namn på den.

$appgroup = Get-CMApplicationGroup -Name "Central app"
Set-CMApplicationGroup -InputObject $appgroup -NewName "Contoso Central App"

Exempel 2: Lägg till ett lokaliserat namn

I det här exemplet konfigureras appgruppen med ett lokaliserat appnamn för språket Språk.

Set-CMApplicationGroup -Name "Contoso Welcome app" -ApplyToLanguageById 60 -LocalizedName "Fáilte romhat"

PARAMETERS

-AddAppCatalog

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

-AddAppCategory

Ange ett eller flera administrativa kategoriobjekt som hjälper dig att filtrera och hitta appgruppen i -konsolen. Hämta dessa objekt med hjälp av cmdleten Get-CMCategory. Dessa kategorier är av typen AppCategories.

Om du vill lägga till kategorier som hjälper användarna att filtrera och hitta program i Software Center använder du parametern AddUserCategory.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddAppCategories

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

-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: False
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

-AddUserCategory

Ange ett eller flera användarkategoriobjekt som hjälper dig att filtrera och hitta appgruppen i -konsolen. Hämta dessa objekt med hjälp av cmdleten Get-CMCategory. Dessa kategorier är av typen CatalogCategories.

Om du vill lägga till kategorier som hjälper användarna att filtrera och hitta program i Software Center använder du parametern AddAppCategory.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddUserCategories

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

-ApplyToLanguageById

För inställningar som visas i Software Center använder du den här parametern för att ange språk-ID för inställningarna.

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).

Om du till exempel vill lägga till ett lokaliserat appnamn för Ireland (Irland):

-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

Lägg till den här parametern för att ta bort alla administrativa kategorier. Om du vill ta bort en enskild kategori använder du parametern RemoveAppCategory.

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

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

-CleanUserCategory

Lägg till den här parametern för att ta bort alla användarkategorier. Om du vill ta bort en enskild kategori använder du parametern RemoveUserCategory.

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

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

-ClearAppCatalog

Lägg till den här parametern för att ta bort alla lokaliserade Software Center-poster. Om du vill ta bort en enskild post använder du parametern 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

Lägg till den här parametern för att ta bort alla ägare. Om du vill ta bort en enskild ägare använder du parametern RemoveOwner.

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

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

-ClearSupportContact

Lägg till den här parametern för att ta bort alla supportkontakter. Om du vill ta bort en enskild kontakt använder du parametern RemoveSupportContact.

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

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

-Id

Ange ID för den appgrupp som ska konfigureras. Det här värdet är samma som CI_ID, till exempel 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

Ange ett appgruppsobjekt som ska konfigureras. Hämta det här objektet med hjälp av cmdleten Get-CMApplicationGroup.

Type: IResultObject
Parameter Sets: SetByValue
Aliases: ApplicationGroup

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
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

-ModelName

Ange programmodell-ID för den appgrupp som ska konfigureras. Det här värdet kallas även för det unika CI-ID:t. Till exempel 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

Ange namnet på den appgrupp som ska konfigureras.

Type: String
Parameter Sets: SetByName
Aliases: LocalizedDisplayName, ApplicationGroupName

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

-NewName

Använd den här parametern för att byta namn på appgruppen. 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

-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

-PassThru

Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten kanske inte några utdata.

Type: SwitchParameter
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

-RemoveAppCatalog

Ange en matris med språk-ID:er för att ta bort de associerade Software Center-posterna. Om du vill ta bort alla poster använder du parametern ClearAppCatalog.

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).

Om du till exempel vill ta bort den lokaliserade Software Center-posten för Ireland (Irland):

-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

Ange en matris med administrativa kategorinamn som ska tas bort. Om du vill ta bort alla administrativa kategorier använder du parametern CleanAppCategory.

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

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

-RemoveApplication

Ange en matris med programnamn som ska tas bort från den här gruppen.

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

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

-RemoveOwner

Ange en matris med ägare som ska tas bort. Om du vill ta bort alla ägare använder du parametern ClearOwner.

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

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

-RemoveSupportContact

Ange en matris med supportkontakter som ska tas bort. Om du vill ta bort alla supportkontakter använder du parametern ClearSupportContact.

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

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

-RemoveUserCategoryName

Ange en matris med användarnamn som ska tas bort. Om du vill ta bort alla användarkategorier använder du parametern CleanUserCategory.

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_ApplicationGroup

Den här cmdleten returnerar SMS_ApplicationGroup WMI-klassobjektet.

ANTECKNINGAR

Get-CMApplicationGroup New-CMApplicationGroup Remove-CMApplicationGroup

New-CMApplicationDisplayInfo

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

Skapa programgrupper