New-CMApplication
Erstellen Sie eine Anwendung.
Syntax
New-CMApplication
[-AddOwner <String[]>]
[-AddSupportContact <String[]>]
[-AppCatalog <AppDisplayInfo[]>]
[-AutoInstall <Boolean>]
[-DefaultLanguageId <Int32>]
[-Description <String>]
[-DisplaySupersedenceInApplicationCatalog <Boolean>]
[-IconLocationFile <String>]
[-IsFeatured <Boolean>]
[-Keyword <String[]>]
[-LinkText <String>]
[-LocalizedDescription <String>]
[-LocalizedName <String>]
[-Name] <String>
[-OptionalReference <String>]
[-Owner <String>]
[-PrivacyUrl <String>]
[-Publisher <String>]
[-ReleaseDate <DateTime>]
[-SoftwareVersion <String>]
[-SupportContact <String>]
[-UserDocumentation <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Verwenden Sie dieses Cmdlet, um eine Anwendung zu erstellen. Eine Configuration Manager-Anwendung definiert die Metadaten zur Anwendung. Weitere Informationen finden Sie unter Erstellen von Anwendungen in Configuration Manager.
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 Anwendung
Dieser Befehl erstellt eine Anwendung mit dem Namen Application01.
New-CMApplication -Name "Application01" -Description "New Application" -Publisher "Contoso" -SoftwareVersion "1.0.0.1" -OptionalReference "Reference" -ReleaseDate 2/24/2016 -AutoInstall $True -Owner "Administrator" -SupportContact "Administrator" -LocalizedName "Application01" -UserDocumentation "https://contoso.com/content" -LinkText "For more information" -LocalizedDescription "New Localized Application" -Keyword "application" -PrivacyUrl "https://contoso.com/library/privacy" -IsFeatured $True -IconLocationFile "\\central\icons\icon.png"
Parameter
-AddOwner
Geben Sie mindestens einen Administrator an, der für diese App 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 |
-AppCatalog
Verwenden Sie diesen Parameter, um einen Softwarecentereintrag für eine bestimmte Sprache anzugeben. Dieser Eintrag kann alle lokalisierten Informationen zur App 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 |
-AutoInstall
Legen Sie diesen Parameter auf $true fest, damit die App aus dem Tasksequenzschritt Anwendung installieren installiert werden kann, ohne bereitgestellt zu werden.
Typ: | Boolean |
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: | False |
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 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 |
-DisplaySupersedenceInApplicationCatalog
Verwenden Sie diesen Parameter nicht. Der Anwendungskatalog wird nicht mehr unterstützt.
Typ: | Boolean |
Aliase: | DisplaySupersedencesInApplicationCatalog |
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 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 |
-IsFeatured
Legen Sie diesen Parameter auf $true fest, um diese Anwendung als ausgewählte App anzuzeigen und im Unternehmensportal hervorzuheben.
Typ: | Boolean |
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.
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 in der ausgewählten Sprache an. Die maximale Länge ist 2048 Zeichen.
Typ: | String |
Aliase: | LocalizedApplicationDescription |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-LocalizedName
Geben Sie den App-Namen 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: | LocalizedApplicationName |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Name
Geben Sie einen Namen für die App an. Die Höchstlänge beträgt 256 Zeichen.
Typ: | String |
Aliase: | LocalizedDisplayName |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-OptionalReference
Geben Sie eine optionale Zeichenfolge an, um die App 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 |
-Owner
Geben Sie einen Administrator an, der für diese App verantwortlich ist.
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 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 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 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 an. Die Höchstlänge beträgt 64 Zeichen.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SupportContact
Geben Sie einen Administrator an, den Endbenutzer kontaktieren können, um Hilfe zu dieser Anwendung zu erhalten.
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 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: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
IResultObject
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_Application WMI-Serverklasse.