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 für die App-Gruppe angeben, werden im Softwarecenter als einzelne Entität angezeigt. Sie können die Apps in der Gruppe so bestellen, 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 auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . 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 Central 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 LocalizedDisplayName-Eigenschaft . Beispiel: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)
| Typ: | String[] |
| Aliase: | AddApplications |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AddOwner
Geben Sie mindestens einen Administrator an, der für diese App-Gruppe verantwortlich ist.
| Typ: | String[] |
| Aliase: | AddOwners |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AddSupportContact
Geben Sie einen oder mehrere Administrative Benutzer an, die Endbenutzer kontaktieren können, um Hilfe zu dieser Anwendung zu erhalten.
| Typ: | String[] |
| Aliase: | AddSupportContacts |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AppGroupCatalog
Verwenden Sie diesen Parameter, um einen Softwarecentereintrag für eine bestimmte Sprache anzugeben. Dieser Eintrag kann alle lokalisierten Informationen zur App-Gruppe enthalten:
- Beschreibung
- IconLocationFile
- Schlüsselwort
- LinkText
- PrivacyUrl
- Position
- UserDocumentation
Verwenden Sie zum Abrufen dieses Objekts das Cmdlet New-CMApplicationDisplayInfo .
| Typ: | AppDisplayInfo[] |
| Aliase: | AppCatalogs |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DefaultLanguageId
Geben Sie die Sprach-ID für die Standardsprache des Softwarecenters an.
Diese ID ist die dezimale Entsprechung der Windows-Sprach-ID. Ist 0x0409 z. B1033. für Englisch (USA) und 2108 ist 0x083C für Irisch (Irland). Weitere Informationen finden Sie unter [MS-LCID]: Referenz zu Windows Language Code Identifier (LCID).
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Geben Sie einen optionalen Administratorkommentar für die App-Gruppe an. Die maximale Länge ist 2048 Zeichen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Keyword
Geben Sie eine Liste von Schlüsselwörtern in der ausgewählten Sprache an. Diese Schlüsselwörter helfen Softwarecenter-Benutzern bei der Suche nach der App-Gruppe.
Tipp
Um mehrere Schlüsselwörter hinzuzufügen, verwenden Sie CultureInfo.CurrentCulture.TextInfo.ListSeparator als Trennzeichen.
| Typ: | String[] |
| Aliase: | Keywords |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-LinkText
Wenn Sie den UserDocumentation-Parameter verwenden, verwenden Sie diesen Parameter, um eine Zeichenfolge anstelle von "Zusätzliche Informationen" im Softwarecenter anzuzeigen. Die Höchstlänge beträgt 128 Zeichen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-LocalizedDescription
Geben Sie eine Beschreibung für diese App-Gruppe in der ausgewählten Sprache an. Die maximale Länge ist 2048 Zeichen.
| Typ: | String |
| Aliase: | LocalizedAppGroupDescription |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-LocalizedName
Geben Sie den Namen der App-Gruppe in der ausgewählten Sprache an. Dieser Name wird im Softwarecenter angezeigt.
Für jede sprache, die Sie hinzufügen, ist ein Name erforderlich.
Die Höchstlänge beträgt 256 Zeichen.
| Typ: | String |
| Aliase: | LocalizedAppGroupName |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Geben Sie einen Namen für die App-Gruppe an. Die Höchstlänge beträgt 256 Zeichen.
| Typ: | String |
| Aliase: | LocalizedDisplayName, ApplicationGroupName |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OptionalReference
Geben Sie eine optionale Zeichenfolge an, um die App-Gruppe in der Konsole zu finden. Die Höchstlänge beträgt 256 Zeichen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PrivacyUrl
Geben Sie eine Websiteadresse für die Datenschutzerklärung für die App-Gruppe an. Das Format muss eine gültige URL sein, z. B https://contoso.com/privacy. . Die maximale Länge der gesamten Zeichenfolge beträgt 128 Zeichen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Publisher
Geben Sie optionale Anbieterinformationen für diese App-Gruppe an. Die Höchstlänge beträgt 256 Zeichen.
| Typ: | String |
| Aliase: | Manufacturer |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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 .
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SoftwareVersion
Geben Sie eine optionale Versionszeichenfolge für die App-Gruppe an. Die Höchstlänge beträgt 64 Zeichen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserDocumentation
Geben Sie den Speicherort einer Datei an, aus der Softwarecenterbenutzer weitere Informationen zu dieser App-Gruppe erhalten können. Dieser Speicherort ist eine Websiteadresse oder ein Netzwerkpfad und Dateiname. Stellen Sie sicher, dass Benutzer Zugriff auf diesen Speicherort haben.
Die maximale Länge der gesamten Zeichenfolge beträgt 256 Zeichen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
IResultObject
Hinweise
Dieses Cmdlet gibt das SMS_ApplicationGroup WMI-Klassenobjekt zurück.