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.