Sdílet prostřednictvím

Set-CMApplicationGroup

  • Článek

SYNOPSIS

Nakonfigurujte existující skupinu aplikací.

SYNTAX

SetByValue (výchozí)

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

Pomocí této rutiny můžete nakonfigurovat nastavení existující skupiny aplikací. Skupinu aplikací použijte k nasazení více aplikací do kolekce jako jednoho nasazení. Metadata, která zadáte o skupině aplikací, se v Centru softwaru nachytá jako jedna entita. Aplikace ve skupině můžete objednat tak, aby je klient instaloval v určitém pořadí. Další informace najdete v tématu Vytvoření skupin aplikací.

Poznámka

Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: Přejmenování skupiny aplikací

Tento příklad získá objekt pro skupinu aplikací a předá ho této rutině, která ji přejmenuje.

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

Příklad 2: Přidání lokalizovaného názvu

V tomto příkladu se pro skupinu aplikací nakonfiguruje lokalizovaný název aplikace pro jazyk Sen.

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

PARAMETERS

-AddAppCatalog

Pomocí tohoto parametru můžete zadat položku Centra softwaru pro konkrétní jazyk. Tato položka může obsahovat všechny lokalizované informace o skupině aplikací:

  • Popis
  • IconLocationFile
  • Klíčové slovo
  • Text odkazu
  • PrivacyUrl
  • Nadpis
  • UserDocumentation (Dokumentování uživatele)

K získání tohoto objektu použijte rutinu 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

Určete jeden nebo více objektů kategorií pro správu, které vám pomůžou filtrovat a najít skupinu aplikací v konzole nástroje . K získání těchto objektů použijte rutinu Get-CMCategory. Tyto kategorie jsou typu AppCategories.

Pokud chcete přidat kategorie, které uživatelům pomůžou filtrovat a hledat aplikace v Centru softwaru, použijte parametr AddUserCategory.

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

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

-AddApplication

Zadejte pole řetězců s názvy aplikací, které se mají přidat do skupiny. Pokud už máte objekt aplikace z jiné rutiny, například Get-CMApplication,jedná se o vlastnost LocalizedDisplayName. Příklad: $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

Zadejte jednoho nebo více administrativních uživatelů, kteří jsou zodpovědní za tuto skupinu aplikací.

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

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

-AddSupportContact

Určete jednoho nebo více administrativních uživatelů, na které můžou koncoví uživatelé s žádostí o pomoc s touto aplikací kontaktovat.

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

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

-AddUserCategory

Určete jeden nebo více objektů kategorií uživatelů, které vám pomůžou filtrovat a najít skupinu aplikací v konzole. K získání těchto objektů použijte rutinu Get-CMCategory. Tyto kategorie jsou typu CatalogKategorie.

Pokud chcete přidat kategorie, které uživatelům pomůžou filtrovat a hledat aplikace v Centru softwaru, použijte parametr AddAppCategory.

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

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

-ApplyToLanguageById

Pro nastavení, která se zobrazují v Centru softwaru, použijte tento parametr k zadání ID jazyka pro nastavení.

Toto ID je desítkový ekvivalent ID Windows jazyka. Například je 1033 pro 0x0409 angličtinu (USA) a 2108 je pro 0x083C Naa (Irsko). Další informace najdete v tématu [MS-LCID]: referenční Windows LCID (Language Code Identifier).

Pokud například chcete přidat lokalizovaný název aplikace proHod (Irsko):

-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

Přidáním tohoto parametru odeberete všechny kategorie pro správu. Pokud chcete odebrat jednu kategorii, použijte parametr RemoveAppCategory.

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

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

-CleanUserCategory

Přidáním tohoto parametru odeberete všechny kategorie uživatelů. Pokud chcete odebrat jednu kategorii, použijte parametr RemoveUserCategory.

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

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

-ClearAppCatalog

Přidáním tohoto parametru odeberete všechny lokalizované položky Centra softwaru. Pokud chcete odebrat jednu položku, použijte parametr 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

Přidáním tohoto parametru odeberte všechny vlastníky. Pokud chcete odebrat jednoho vlastníka, použijte parametr RemoveOwner.

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

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

-ClearSupportContact

Přidáním tohoto parametru odeberete všechny kontakty podpory. Pokud chcete odebrat jeden kontakt, použijte parametr RemoveSupportContact.

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

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

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

-DefaultLanguageId

Zadejte ID jazyka výchozího jazyka Centra softwaru.

Toto ID je desítkový ekvivalent ID Windows jazyka. Například je 1033 pro 0x0409 angličtinu (USA) a 2108 je pro 0x083C Naa (Irsko). Další informace najdete v tématu [MS-LCID]: referenční Windows LCID (Language Code Identifier).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Description (Popis)

Zadejte volitelný komentář správce pro skupinu aplikací. Maximální délka je 2 048 znaků.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-IconLocationFile

Zadejte cestu k souboru, který obsahuje ikonu pro tuto skupinu aplikací. Ikony mohou mít rozměry pixelů až 512 × 512. Soubor může být následujícího typu souboru obrázku a ikony:

  • 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

Zadejte ID skupiny aplikací, která se má nakonfigurovat. Tato hodnota je stejná jako CI_ID, například 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

Zadejte objekt skupiny aplikací, který chcete nakonfigurovat. K získání tohoto objektu použijte rutinu 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

-Keyword

Zadejte seznam klíčových slov ve vybraném jazyce. Tato klíčová slova pomáhají uživatelům Centra softwaru vyhledávat skupinu aplikací.

Tip

Pokud chcete přidat více klíčových slov, použijte jako oddělovač CultureInfo.CurrentCulture.TextInfo.ListSeparator.

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

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

-LinkText

Pokud použijete parametr UserDocumentation, použijte tento parametr k zobrazení řetězce místo "Další informace" v Centru softwaru. Maximální délka je 128 znaků.

Type: String
Parameter Sets: (All)
Aliases:

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

-LocalizedDescription

Zadejte popis této skupiny aplikací ve vybraném jazyce. Maximální délka je 2 048 znaků.

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

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

-LocalizedName

Zadejte název skupiny aplikací ve vybraném jazyce. Tento název se zobrazí v Centru softwaru.

Název je vyžadován pro každý jazyk, který přidáte.

Maximální délka je 256 znaků.

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

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

-ModelName

Zadejte identifikátor aplikačního modelu skupiny aplikací, která se má nakonfigurovat. Tato hodnota se také označuje jako jedinečné ID CI. Například, 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

Zadejte název skupiny aplikací, která se má nakonfigurovat.

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

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

-NewName

Tento parametr použijte k přejmenování skupiny aplikací. Maximální délka je 256 znaků.

Type: String
Parameter Sets: (All)
Aliases:

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

-OptionalReference

Zadejte volitelný řetězec, který vám pomůže najít skupinu aplikací v konzole. Maximální délka je 256 znaků.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Přidáním tohoto parametru vrátíte objekt, který představuje položku, se kterou pracujete. Ve výchozím nastavení tato rutina nemusí generovat žádný výstup.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-PrivacyUrl

Zadejte adresu webu pro prohlášení o zásadách ochrany osobních údajů pro skupinu aplikací. Formát musí být platná adresa URL, například https://contoso.com/privacy . Maximální délka celého řetězce je 128 znaků.

Type: String
Parameter Sets: (All)
Aliases:

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

-Publisher

Zadejte volitelné informace o dodavateli pro tuto skupinu aplikací. Maximální délka je 256 znaků.

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

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

-ReleaseDate

Zadejte objekt data pro datum vydání této skupiny aplikací. K získání tohoto objektu použijte integrovanou rutinu Get-Date.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-RemoveAppCatalog

Zadejte pole ID jazyků pro odebrání přidružených položek Centra softwaru. Pokud chcete odebrat všechny položky, použijte parametr ClearAppCatalog.

Toto ID je desítkový ekvivalent ID Windows jazyka. Například je 1033 pro 0x0409 angličtinu (USA) a 2108 je pro 0x083C Naa (Irsko). Další informace najdete v tématu [MS-LCID]: referenční Windows LCID (Language Code Identifier).

Pokud například chcete odebrat lokalizovaný záznam Centra softwaru proHod (Irsko):

-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

Zadejte pole názvů kategorií pro správu, které chcete odebrat. Pokud chcete odebrat všechny kategorie pro správu, použijte parametr CleanAppCategory.

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

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

-RemoveApplication

Zadejte pole názvů aplikací, které chcete z této skupiny odebrat.

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

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

-RemoveOwner

Zadejte pole vlastníků, které chcete odebrat. Pokud chcete odebrat všechny vlastníky, použijte parametr ClearOwner.

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

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

-RemoveSupportContact

Zadejte pole kontaktů podpory, které chcete odebrat. Pokud chcete odebrat všechny kontakty podpory, použijte parametr ClearSupportContact.

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

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

-RemoveUserCategoryName

Zadejte pole názvů kategorií uživatelů, které se mají odebrat. Pokud chcete odebrat všechny kategorie uživatelů, použijte parametr CleanUserCategory.

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

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

-SoftwareVersion

Zadejte volitelný řetězec verze pro skupinu aplikací. Maximální délka je 64 znaků.

Type: String
Parameter Sets: (All)
Aliases:

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

-UserDocumentation

Zadejte umístění souboru, ze kterého mohou uživatelé Centra softwaru získat další informace o této skupině aplikací. Toto umístění je adresa webu nebo síťová cesta a název souboru. Ujistěte se, že uživatelé mají k tomuto umístění přístup.

Maximální délka celého řetězce je 256 znaků.

Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespouštěl.

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

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

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_ApplicationGroup

Tato rutina vrátí SMS_ApplicationGroup objektu třídy WMI.

POZNÁMKY

Get-CMApplicationGroup New-CMApplicationGroup Remove-CMApplicationGroup

New-CMApplicationDisplayInfo

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

Vytvoření skupin aplikací