New-CMApplicationGroup
Erstellen Sie eine neue Anwendungsgruppe.
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>]
Beschreibung
Verwenden Sie dieses Cmdlet, um eine Anwendungsgruppe zu erstellen. Verwenden Sie eine Anwendungsgruppe, 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.
Es gibt einige Einstellungen einer App-Gruppe, die Sie beim Erstellen nicht konfigurieren können. Verwenden Sie zum Konfigurieren anderer Einstellungen das Cmdlet "Set-CMApplicationGroup".
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: Erstellen einer Gruppe mit zwei Apps
In diesem Beispiel wird eine neue App-Gruppe namens "Zentrale App" erstellt, die zwei Apps enthält.
$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'
Parameter
-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 |
-AppGroupCatalog
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 |
-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 |
-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 |
-Name
Geben Sie einen Namen für die App-Gruppe an. Die Höchstlänge beträgt 256Zeichen.
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationGroupName |
Position: | 0 |
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 |
-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 |
-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
Keine
Ausgaben
IResultObject
Hinweise
Dieses Cmdlet gibt das SMS_ApplicationGroup WMI-Klassenobjekt zurück.