New-CMApplication

Referenz

Modul:: ConfigurationManager

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 der Anwendung. Weitere Informationen finden Sie unter Erstellen von Anwendungen in Configuration Manager.

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 Anwendung

Mit diesem Befehl wird eine Anwendung mit dem Namen "Application01" erstellt.

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 einen oder mehrere Administrative Benutzer an, die für diese App 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

-AppCatalog

Verwenden Sie diesen Parameter, um einen Software Center-Eintrag für eine bestimmte Sprache anzugeben. Dieser Eintrag kann alle lokalisierten Informationen zur App 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

-AutoInstall

Legen Sie diesen Parameter auf $true fest, damit die App über den Tasksequenzschritt "Anwendung installieren" installiert werden kann, ohne bereitgestellt zu werden.

Type:	Boolean
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:	False
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 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

-DisplaySupersedenceInApplicationCatalog

Verwenden Sie diesen Parameter nicht. Der Anwendungskatalog wird nicht mehr unterstützt.

Type:	Boolean
Aliases:	DisplaySupersedencesInApplicationCatalog
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 enthält. Symbole können Pixelabmessungen von bis zu 512 x 512 haben. Die Datei kann die folgenden Bild- und Symboldateitypen aufweisen:

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IsFeatured

Legen Sie diesen Parameter auf $true fest, um diese Anwendung als empfohlene App anzuzeigen und im Unternehmensportal hervorzuheben.

Type:	Boolean
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 in der ausgewählten Sprache an. Die maximale Länge ist 2048 Zeichen.

Type:	String
Aliases:	LocalizedApplicationDescription
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LocalizedName

Geben Sie den App-Namen 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:	LocalizedApplicationName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Geben Sie einen Namen für die App an. Die Höchstlänge beträgt 256Zeichen.

Type:	String
Aliases:	LocalizedDisplayName
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 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

-Owner

Geben Sie einen Administratorbenutzer an, der für diese App verantwortlich ist.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PrivacyUrl

Geben Sie eine Websiteadresse für die Datenschutzerklärung für die App 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 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 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.

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 an. Die Höchstlänge beträgt 64Zeichen.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SupportContact

Geben Sie einen Administratorbenutzer an, an den sich Endbenutzer wenden können, um Hilfe zu dieser Anwendung zu erhalten.

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 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:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

Keine

Ausgaben

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_Application Server-WMI-Klasse.