New-CMApplication

创建应用程序。

语法

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

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

Type:String[]
Aliases:AddOwners
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AddSupportContact

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

Type:String[]
Aliases:AddSupportContacts
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AppCatalog

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

  • 说明
  • IconLocationFile
  • 关键字
  • LinkText
  • PrivacyUrl
  • Title
  • UserDocumentation

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

Type:AppDisplayInfo[]
Aliases:AppCatalogs
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AutoInstall

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

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultLanguageId

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

此 ID 是语言 ID Windows等效项。 例如, 1033 适用于英语 0x0409 ** (美国) ,** 适用于爱尔兰 (2108 0x083C **爱尔兰) 。 ** 有关详细信息,请参阅[MS-LCID]:Windows语言代码标识符 (LCID) 参考

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

-DisableWildcardHandling

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

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

-DisplaySupersedenceInApplicationCatalog

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

Type:Boolean
Aliases:DisplaySupersedencesInApplicationCatalog
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

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

-IconLocationFile

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

  • DLL
  • EXE
  • JPG
  • ICO
  • PNG
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IsFeatured

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

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

-Keyword

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

提示

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

Type:String[]
Aliases:Keywords
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-LinkText

使用 UserDocumentation 参数时,使用此参数在软件中心中显示一个字符串,以表示"其他信息"。 最大长度为 128 个字符。

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

-LocalizedDescription

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

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

-LocalizedName

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

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

长度不得超过 256 个字符。

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

-OptionalReference

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

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

-Owneer

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

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

-PrivacyUrl

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

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

-Publisher

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

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

-ReleaseDate

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

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

-SoftwareVersion

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

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

-SupportContact

指定最终用户可以联系以寻求帮助的管理用户。

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

-UserDocumentation

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

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

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-名称

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

Type:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-描述

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

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

输入

输出

IResultObject

IResultObject

备注

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