Freigeben über


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.