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 类。