Set-CMApplicationGroup

Konfigurieren sie eine vorhandene Anwendungsgruppe.

Syntax

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>]
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>]
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>]
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>]

Beschreibung

Verwenden Sie dieses Cmdlet, um die Einstellungen einer vorhandenen Anwendungsgruppe zu konfigurieren. Verwenden Sie eine App-Gruppe, um mehrere Anwendungen in einer Sammlung als einzelne Bereitstellung bereitzustellen. Die Metadaten, die Sie zur App-Gruppe angeben, werden im Software Center als einzelne Entität angezeigt. Sie können die Apps in der Gruppe so anordnen, dass sie vom Client in einer bestimmten Reihenfolge installiert werden. Weitere Informationen finden Sie unter Erstellen von Anwendungsgruppen.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Umbenennen einer App-Gruppe

In diesem Beispiel wird ein Objekt für die App-Gruppe abgerufen und an dieses Cmdlet übergeben, um es umzubenennen.

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

Beispiel 2: Hinzufügen eines lokalisierten Namens

In diesem Beispiel wird die App-Gruppe mit einem lokalisierten App-Namen für die Sprache "Domänennamen" konfiguriert.

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

Parameter

-AddAppCatalog

Verwenden Sie diesen Parameter, um einen Software Center-Eintrag für eine bestimmte Sprache anzugeben. Dieser Eintrag kann alle lokalisierten Informationen zur App-Gruppe enthalten:

  • Beschreibung
  • IconLocationFile
  • Schlüsselwort
  • LinkText
  • PrivacyUrl
  • Titel
  • UserDocumentation

Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "New-CMApplicationDisplayInfo".

Type:AppDisplayInfo[]
Aliases:AppCatalogs
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddAppCategory

Geben Sie ein oder mehrere administrative Kategorieobjekte an, mit denen Sie die App-Gruppe in der Konsole filtern und suchen können. Verwenden Sie zum Abrufen dieser Objekte das Cmdlet "Get-CMCategory". Diese Kategorien sind vom Typ "AppCategories".

Verwenden Sie den Parameter "AddUserCategory", um Benutzer beim Filtern und Suchen von Anwendungen im Software Center zu unterstützen, um Kategorien hinzuzufügen.

Type:IResultObject[]
Aliases:AddAppCategories
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddApplication

Geben Sie ein Zeichenfolgenarray von App-Namen an, die der Gruppe hinzugefügt werden sollen. Wenn Sie bereits über ein App-Objekt aus einem anderen Cmdlet wie "Get-CMApplication"verfügen, ist dieser Wert die Eigenschaft "LocalizedDisplayName". Beispiel: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)

Type:String[]
Aliases:AddApplications
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddOwner

Geben Sie einen oder mehrere Administrative Benutzer an, die für diese App-Gruppe verantwortlich sind.

Type:String[]
Aliases:AddOwners
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddSupportContact

Geben Sie einen oder mehrere Administrative Benutzer an, an die sich Endbenutzer wenden können, um Hilfe zu dieser Anwendung zu erhalten.

Type:String[]
Aliases:AddSupportContacts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddUserCategory

Geben Sie ein oder mehrere Benutzerkategorieobjekte an, die Sie beim Filtern und Suchen der App-Gruppe in der Konsole unterstützen sollen. Verwenden Sie zum Abrufen dieser Objekte das Cmdlet "Get-CMCategory". Diese Kategorien sind vom Typ CatalogCategories.

Verwenden Sie den Parameter "AddAppCategory", um Benutzer beim Filtern und Suchen von Anwendungen im Software Center zu unterstützen, um Kategorien hinzuzufügen.

Type:IResultObject[]
Aliases:AddUserCategories
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ApplyToLanguageById

Verwenden Sie für Einstellungen, die im Software Center angezeigt werden, diesen Parameter, um die Sprach-ID für die Einstellungen anzugeben.

Diese ID ist die Dezimalentsprechung der Windows Sprach-ID. Ist beispielsweise 1033 0x0409 für Englisch (USA) und 2108 für Japan 0x083C (Irland). Weitere Informationen finden Sie unter [MS-LCID]: Windows Language Code Identifier (LCID)-Referenz.

Wenn Sie z. B. einen lokalisierten App-Namen für Ireland (Irland) hinzufügen möchten:

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

Type:Int32
Aliases:ApplySettingToSpecificLanguage
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CleanAppCategory

Fügen Sie diesen Parameter hinzu, um alle administrativen Kategorien zu entfernen. Um eine einzelne Kategorie zu entfernen, verwenden Sie den Parameter RemoveAppCategory.

Type:SwitchParameter
Aliases:CleanAppCategories
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CleanUserCategory

Fügen Sie diesen Parameter hinzu, um alle Benutzerkategorien zu entfernen. Um eine einzelne Kategorie zu entfernen, verwenden Sie den Parameter "RemoveUserCategory".

Type:SwitchParameter
Aliases:CleanUserCategories
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ClearAppCatalog

Fügen Sie diesen Parameter hinzu, um alle lokalisierten Software Center-Einträge zu entfernen. Um einen einzelnen Eintrag zu entfernen, verwenden Sie den Parameter RemoveAppCatalog.

Type:SwitchParameter
Aliases:ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ClearOwner

Fügen Sie diesen Parameter hinzu, um alle Besitzer zu entfernen. Um einen einzelnen Besitzer zu entfernen, verwenden Sie den Parameter RemoveOwner.

Type:SwitchParameter
Aliases:CleanOwners
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ClearSupportContact

Fügen Sie diesen Parameter hinzu, um alle Supportkontakte zu entfernen. Um einen einzelnen Kontakt zu entfernen, verwenden Sie den Parameter RemoveSupportContact.

Type:SwitchParameter
Aliases:CleanSupportContacts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DefaultLanguageId

Geben Sie die Sprach-ID für die Standardmäßige Software Center-Sprache an.

Diese ID ist die Dezimalentsprechung der Windows Sprach-ID. Ist beispielsweise 1033 0x0409 für Englisch (USA) und 2108 für Japan 0x083C (Irland). Weitere Informationen finden Sie unter [MS-LCID]: Windows Language Code Identifier (LCID)-Referenz.

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

-Description

Geben Sie einen optionalen Administratorkommentar für die App-Gruppe an. Die maximale Länge ist 2048 Zeichen.

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-IconLocationFile

Geben Sie den Pfad zu der Datei an, die das Symbol für diese App-Gruppe enthält. Symbole können Pixelabmessungen von bis zu 512 x 512 haben. Die Datei kann die folgenden Bild- und Symboldateitypen aufweisen:

  • DLL
  • EXE
  • JPG
  • ICO
  • PNG
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Id

Geben Sie die ID der zu konfigurierenden App-Gruppe an. Dieser Wert ist identisch mit dem CI_ID, 1025866 z. B. .

Type:Int32
Aliases:CIId, CI_ID
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Geben Sie ein zu konfigurierende App-Gruppenobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMApplicationGroup".

Type:IResultObject
Aliases:ApplicationGroup
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-LinkText

Wenn Sie den Parameter UserDocumentation verwenden, verwenden Sie diesen Parameter, um eine Zeichenfolge anstelle von "Zusätzliche Informationen" im Software Center anzuzeigen. Die Höchstlänge beträgt 128 Zeichen.

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

-LocalizedDescription

Geben Sie eine Beschreibung für diese App-Gruppe in der ausgewählten Sprache an. Die maximale Länge ist 2048 Zeichen.

Type:String
Aliases:LocalizedAppGroupDescription
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-LocalizedName

Geben Sie den Namen der App-Gruppe in der ausgewählten Sprache an. Dieser Name wird im Software Center angezeigt.

Für jede sprache, die Sie hinzufügen, ist ein Name erforderlich.

Die Höchstlänge beträgt 256Zeichen.

Type:String
Aliases:LocalizedAppGroupName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ModelName

Geben Sie den Anwendungsmodellbezeichner der zu konfigurierenden App-Gruppe an. Dieser Wert wird auch als CI Unique IDbezeichnet. Beispiel: ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed.

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

-Name

Geben Sie den Namen der zu konfigurierenden App-Gruppe an.

Type:String
Aliases:LocalizedDisplayName, ApplicationGroupName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Verwenden Sie diesen Parameter, um die App-Gruppe umzubenennen. Die Höchstlänge beträgt 256Zeichen.

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

-OptionalReference

Geben Sie eine optionale Zeichenfolge an, die Ihnen dabei hilft, die App-Gruppe in der Konsole zu finden. Die Höchstlänge beträgt 256Zeichen.

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

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

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

-PrivacyUrl

Geben Sie eine Websiteadresse für die Datenschutzbestimmungen für die App-Gruppe an. Das Format muss eine gültige URL sein, https://contoso.com/privacy z. B. . Die maximale Länge der gesamten Zeichenfolge beträgt 128 Zeichen.

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

-Publisher

Geben Sie optionale Anbieterinformationen für diese App-Gruppe an. Die Höchstlänge beträgt 256Zeichen.

Type:String
Aliases:Manufacturer
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ReleaseDate

Geben Sie ein Datumsobjekt für die Veröffentlichung dieser App-Gruppe an. Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet "Get-Date".

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

-RemoveAppCatalog

Geben Sie ein Array von Sprach-IDs an, um die zugehörigen Software Center-Einträge zu entfernen. Um alle Einträge zu entfernen, verwenden Sie den Parameter ClearAppCatalog.

Diese ID ist die Dezimalentsprechung der Windows Sprach-ID. Ist beispielsweise 1033 0x0409 für Englisch (USA) und 2108 für Japan 0x083C (Irland). Weitere Informationen finden Sie unter [MS-LCID]: Windows Language Code Identifier (LCID)-Referenz.

So entfernen Sie z. B. den lokalisierten Software Center-Eintrag für Japan (Irland):

-RemoveAppCatalog 2108

Type:Int32[]
Aliases:RemoveAppCatalogsByLanguageId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveAppCategoryName

Geben Sie ein Array von administrativen Kategorienamen an, die entfernt werden sollen. Um alle administrativen Kategorien zu entfernen, verwenden Sie den Parameter CleanAppCategory.

Type:String[]
Aliases:RemoveAppCategoryNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveApplication

Geben Sie ein Array von Anwendungsnamen an, die aus dieser Gruppe entfernt werden sollen.

Type:String[]
Aliases:RemoveApplications
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveOwner

Geben Sie ein Array von Besitzern an, die entfernt werden sollen. Um alle Besitzer zu entfernen, verwenden Sie den ClearOwner-Parameter.

Type:String[]
Aliases:RemoveOwners
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveSupportContact

Geben Sie ein Array von Supportkontakten an, die entfernt werden sollen. Um alle Supportkontakte zu entfernen, verwenden Sie den Parameter ClearSupportContact.

Type:String[]
Aliases:RemoveSupportContacts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RemoveUserCategoryName

Geben Sie ein Array von Benutzerkategorienamen an, die entfernt werden sollen. Um alle Benutzerkategorien zu entfernen, verwenden Sie den Parameter CleanUserCategory.

Type:String[]
Aliases:RemoveUserCategoryNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Schlüsselwort

Geben Sie eine Liste der Schlüsselwörter in der ausgewählten Sprache an. Diese Schlüsselwörter helfen Software Center-Benutzern bei der Suche nach der App-Gruppe.

Tipp

Um mehrere Schlüsselwörter hinzuzufügen, verwenden Sie CultureInfo.CurrentCulture.TextInfo.ListSeparator als Trennzeichen.

Type:String[]
Aliases:Keywords
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareVersion

Geben Sie eine optionale Versionszeichenfolge für die App-Gruppe an. Die Höchstlänge beträgt 64Zeichen.

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

-UserDocumentation

Geben Sie den Speicherort einer Datei an, aus der Software Center-Benutzer weitere Informationen zu dieser App-Gruppe erhalten können. Dieser Speicherort ist eine Websiteadresse oder ein Netzwerkpfad und Dateiname. Stellen Sie sicher, dass Die Benutzer Zugriff auf diesen Speicherort haben.

Die maximale Länge der gesamten Zeichenfolge beträgt 256 Zeichen.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject

Dieses Cmdlet gibt das SMS_ApplicationGroup WMI-Klassenobjekt zurück.