New-CMApplication

模块:

ConfigurationManager

创建应用程序。

语法

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>]

说明

使用此 cmdlet 创建应用程序。 Configuration Manager 应用程序定义有关应用程序的元数据。 有关详细信息，请参阅 在 Configuration Manager 中创建应用程序。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1：创建应用程序

此命令创建名为 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"

参数

-AddOwner

指定负责此应用的一个或多个管理用户。

类型:	String[]
别名:	AddOwners
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AddSupportContact

指定最终用户可以联系以获取此应用程序的帮助的一个或多个管理用户。

类型:	String[]
别名:	AddSupportContacts
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AppCatalog

使用此参数可指定特定语言的软件中心条目。 此条目可以包括有关应用的所有本地化信息：

• 说明
• IconLocationFile
• 关键字
• LinkText
• PrivacyUrl
• 标题
• UserDocumentation

若要获取此对象，请使用 New-CMApplicationDisplayInfo cmdlet。

类型:	AppDisplayInfo[]
别名:	AppCatalogs
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AutoInstall

将此参数设置为 $true 以允许从安装应用程序任务序列步骤安装应用，而无需部署。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultLanguageId

指定默认软件中心语言的语言 ID。

此 ID 是 Windows 语言 ID 的等效小数。 例如， 1033 表示0x0409英语 (美国) ，而 21080x083C 对于爱尔兰 (爱尔兰) 。 有关详细信息，请参阅 [MS-LCID]：Windows 语言代码标识符 (LCID) 参考。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Description

为应用指定可选的管理员注释。 最大长度为 2048 个字符。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplaySupersedenceInApplicationCatalog

请勿使用此参数。 不再支持应用程序目录。

类型:	Boolean
别名:	DisplaySupersedencesInApplicationCatalog
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IconLocationFile

指定包含此应用图标的文件的路径。 图标的像素尺寸最大可以为 512x512。 该文件可以是以下图像和图标文件类型：

• DLL
• EXE
• JPG
• ICO
• PNG

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IsFeatured

将此参数设置为 $true ，将此应用程序显示为特色应用，并在公司门户中突出显示它。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Keyword

指定所选语言中的关键字列表。 这些关键字可帮助软件中心用户搜索应用。

提示

若要添加多个关键字，请使用 CultureInfo.CurrentCulture.TextInfo.ListSeparator 作为分隔符。

类型:	String[]
别名:	Keywords
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LinkText

使用 UserDocumentation 参数时，使用此参数可显示一个字符串来代替软件中心的“附加信息”。 最大长度为 128 个字符。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LocalizedDescription

以所选语言指定此应用的说明。 最大长度为 2048 个字符。

类型:	String
别名:	LocalizedApplicationDescription
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LocalizedName

指定所选语言的应用名称。 此名称显示在软件中心。

添加的每种语言都需要一个名称。

长度不得超过 256 个字符。

类型:	String
别名:	LocalizedApplicationName
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定应用的名称。 长度不得超过 256 个字符。

类型:	String
别名:	LocalizedDisplayName
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OptionalReference

指定一个可选字符串，以帮助在控制台中查找应用。 长度不得超过 256 个字符。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Owner

指定负责此应用的管理用户。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PrivacyUrl

为应用隐私声明指定网站地址。 格式必须是有效的 URL，例如 https://contoso.com/privacy。 整个字符串的最大长度为 128 个字符。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Publisher

为此应用指定可选供应商信息。 长度不得超过 256 个字符。

类型:	String
别名:	Manufacturer
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ReleaseDate

指定发布此应用的日期对象。 若要获取此对象，请使用 Get-Date 内置 cmdlet。

类型:	DateTime
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SoftwareVersion

指定应用的可选版本字符串。 最大长度为 64 个字符。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SupportContact

指定一个管理用户，最终用户可以联系以获取有关此应用程序的帮助。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UserDocumentation

指定文件的位置，软件中心用户可以从中获取有关此应用的详细信息。 此位置是网站地址或网络路径和文件名。 确保用户有权访问此位置。

整个字符串的最大长度为 256 个字符。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

输出

IResultObject

IResultObject

备注

有关此返回对象及其属性的详细信息，请参阅 SMS_Application服务器 WMI 类。

相关链接

• Convert-CMApplication
• ConvertFrom-CMApplication
• ConvertTo-CMApplication
• Export-CMApplication
• Get-CMApplication
• Import-CMApplication
• Remove-CMApplication
• Resume-CMApplication
• Set-CMApplication
• Suspend-CMApplication
• New-CMApplicationDisplayInfo
• 在 Configuration Manager 中创建应用程序