Set-CMApplication

  • 参考
模块:
ConfigurationManager

配置应用程序的属性。

语法

Set-CMApplication
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-AddAppCategory <IResultObject[]>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AddUserCategory <IResultObject[]>]
   [-AppCategory <String[]>]
   [-ApplyToLanguageById <Int32>]
   [-AutoInstall <Boolean>]
   [-CleanAppCategory]
   [-CleanUserCategory]
   [-ClearAppCatalog]
   [-ClearOwner]
   [-ClearSupportContact]
   [-DefaultLanguageId <Int32>]
   [-Description <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DistributionPointSetting <DistributionPointSettingType>]
   [-DistributionPriority <DistributionPriorityType>]
   [-IconLocationFile <String>]
   [-InputObject] <IResultObject>
   [-IsFeatured <Boolean>]
   [-Keyword <String[]>]
   [-LinkText <String>]
   [-LocalizedApplicationName <String>]
   [-LocalizedDescription <String>]
   [-NewName <String>]
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PassThru]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-RemoveAppCatalog <Int32[]>]
   [-RemoveAppCategoryName <String[]>]
   [-RemoveOwner <String[]>]
   [-RemoveSupportContact <String[]>]
   [-RemoveUserCategoryName <String[]>]
   [-SendToProtectedDistributionPoint <Boolean>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserCategory <String[]>]
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplication
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-AddAppCategory <IResultObject[]>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AddUserCategory <IResultObject[]>]
   [-AppCategory <String[]>]
   [-ApplyToLanguageById <Int32>]
   [-AutoInstall <Boolean>]
   [-CleanAppCategory]
   [-CleanUserCategory]
   [-ClearAppCatalog]
   [-ClearOwner]
   [-ClearSupportContact]
   [-DefaultLanguageId <Int32>]
   [-Description <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DistributionPointSetting <DistributionPointSettingType>]
   [-DistributionPriority <DistributionPriorityType>]
   [-IconLocationFile <String>]
   [-Id] <Int32>
   [-IsFeatured <Boolean>]
   [-Keyword <String[]>]
   [-LinkText <String>]
   [-LocalizedApplicationName <String>]
   [-LocalizedDescription <String>]
   [-NewName <String>]
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PassThru]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-RemoveAppCatalog <Int32[]>]
   [-RemoveAppCategoryName <String[]>]
   [-RemoveOwner <String[]>]
   [-RemoveSupportContact <String[]>]
   [-RemoveUserCategoryName <String[]>]
   [-SendToProtectedDistributionPoint <Boolean>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserCategory <String[]>]
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplication
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-AddAppCategory <IResultObject[]>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AddUserCategory <IResultObject[]>]
   [-AppCategory <String[]>]
   [-ApplyToLanguageById <Int32>]
   [-AutoInstall <Boolean>]
   [-CleanAppCategory]
   [-CleanUserCategory]
   [-ClearAppCatalog]
   [-ClearOwner]
   [-ClearSupportContact]
   [-DefaultLanguageId <Int32>]
   [-Description <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DistributionPointSetting <DistributionPointSettingType>]
   [-DistributionPriority <DistributionPriorityType>]
   [-IconLocationFile <String>]
   [-IsFeatured <Boolean>]
   [-Keyword <String[]>]
   [-LinkText <String>]
   [-LocalizedApplicationName <String>]
   [-LocalizedDescription <String>]
   -ModelName <String>
   [-NewName <String>]
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PassThru]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-RemoveAppCatalog <Int32[]>]
   [-RemoveAppCategoryName <String[]>]
   [-RemoveOwner <String[]>]
   [-RemoveSupportContact <String[]>]
   [-RemoveUserCategoryName <String[]>]
   [-SendToProtectedDistributionPoint <Boolean>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserCategory <String[]>]
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplication
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-AddAppCategory <IResultObject[]>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AddUserCategory <IResultObject[]>]
   [-AppCategory <String[]>]
   [-ApplyToLanguageById <Int32>]
   [-AutoInstall <Boolean>]
   [-CleanAppCategory]
   [-CleanUserCategory]
   [-ClearAppCatalog]
   [-ClearOwner]
   [-ClearSupportContact]
   [-DefaultLanguageId <Int32>]
   [-Description <String>]
   [-DisplaySupersedenceInApplicationCatalog <Boolean>]
   [-DistributionPointSetting <DistributionPointSettingType>]
   [-DistributionPriority <DistributionPriorityType>]
   [-IconLocationFile <String>]
   [-IsFeatured <Boolean>]
   [-Keyword <String[]>]
   [-LinkText <String>]
   [-LocalizedApplicationName <String>]
   [-LocalizedDescription <String>]
   [-Name] <String>
   [-NewName <String>]
   [-OptionalReference <String>]
   [-Owner <String>]
   [-PassThru]
   [-PrivacyUrl <String>]
   [-Publisher <String>]
   [-ReleaseDate <DateTime>]
   [-RemoveAppCatalog <Int32[]>]
   [-RemoveAppCategoryName <String[]>]
   [-RemoveOwner <String[]>]
   [-RemoveSupportContact <String[]>]
   [-RemoveUserCategoryName <String[]>]
   [-SendToProtectedDistributionPoint <Boolean>]
   [-SoftwareVersion <String>]
   [-SupportContact <String>]
   [-UserCategory <String[]>]
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用 Set-CMApplication cmdlet 配置应用程序的设置。

注意

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

示例

示例 1：重新配置应用程序的属性

第一个命令获取名为 Application01 的应用程序对象。 接下来的两个命令使用 Get-CMCategory cmdlet 获取用户和管理员类别的对象。 然后 ，Set-CMApplication cmdlet 在 Applicaton01 上设置指定的属性。

$app = Get-CMApplication -Name "Application01"
$userCat = Get-CMCategory -Name "Test Applications" -CategoryType CatalogCategories
$adminCat = Get-CMCategory -Name "Testing" -CategoryType AppCategories

Set-CMApplication -InputObject $app -NewName "Application01_New" -Description "Application updated" -Publisher "Test group" -SoftwareVersion "1.0.0.1" -OptionalReference "Reference" -ReleaseDate 2/24/2016 -AutoInstall $True -Owner "jqpublic" -SupportContact "jqpublic" -LocalizedApplicationName "Localized Application01" -UserDocumentation "https://contoso.com/content" -LinkText "For more info" -LocalizedDescription "Localized Application New" -Keyword "Application" -PrivacyUrl "https://contoso.com/privacy" -IsFeatured $True -IconLocationFile "C:\Users\art\icon.png" -DistributionPriority Medium -SendToProtectedDistributionPoint $True -DistributionPointSetting NoDownload -AddUserCategory $userCat -AddAppCategory $adminCat

参数

-AddAppCatalog

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

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

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

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

-AddAppCategory

指定一个或多个管理类别对象，以帮助在控制台中筛选和查找应用。 若要获取这些对象，请使用 Get-CMCategory cmdlet。 这些类别的类型为 AppCategories。

若要添加类别以帮助用户在软件中心中筛选和查找应用程序，请使用 AddUserCategory 参数。

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

-AddOwner

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

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

-AddSupportContact

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

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

-AddUserCategory

指定一个或多个用户类别对象，以帮助在控制台中筛选和查找应用组。 若要获取这些对象，请使用 Get-CMCategory cmdlet。 这些类别的类型为 CatalogCategories。

若要添加类别以帮助用户在软件中心中筛选和查找应用程序，请使用 AddAppCategory 参数。

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

-AppCategory

此参数已弃用，请使用 -AddAppCategory。

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

-ApplyToLanguageById

对于在软件中心中显示的设置，请使用此参数指定设置的语言 ID。

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

例如，若要为 爱尔兰 (爱尔兰 添加本地化应用名称，) ：

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

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

-AutoInstall

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

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

-CleanAppCategory

添加此参数可删除所有管理类别。 若要删除单个类别，请使用 RemoveAppCategory 参数。

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

-CleanUserCategory

添加此参数可删除所有用户类别。 若要删除单个类别，请使用 RemoveUserCategory 参数。

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

-ClearAppCatalog

添加此参数可删除所有本地化的软件中心条目。 若要删除单个条目，请使用 RemoveAppCatalog 参数。

类型:SwitchParameter
别名:ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ClearOwner

添加此参数可删除所有所有者。 若要删除单个所有者，请使用 RemoveOwner 参数。

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

-ClearSupportContact

添加此参数可删除所有支持联系人。 若要删除单个联系人，请使用 RemoveSupportContact 参数。

类型:SwitchParameter
别名:CleanSupportContacts
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

-DistributionPointSetting

指定预留分发点设置：

  • AutoDownload：将包分配到分发点时自动下载内容。

  • DeltaCopy：仅将内容更改下载到分发点。

  • NoDownload：手动将此包中的内容复制到分发点。

类型:DistributionPointSettingType
接受的值:AutoDownload, DeltaCopy, NoDownload
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DistributionPriority

指定站点将内容发送到其他站点和此站点中的分发点的顺序。

网站在优先级为中等或低优先级的内容之前发送高优先级内容。 优先级相等的内容按创建顺序发送。

类型:DistributionPriorityType
接受的值:High, Medium, Low
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

-Id

指定要配置的应用的 ID。 此值与 CI_ID相同，例如 1025866。

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

-InputObject

指定要配置的应用对象。 若要获取此对象，请使用 Get-CMApplication cmdlet。

类型:IResultObject
别名:Application
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符: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

-LocalizedApplicationName

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

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

长度不得超过 256 个字符。

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

-LocalizedDescription

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

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

-ModelName

指定要配置的应用的应用程序模型标识符。 此值也称为 CI 唯一 ID。 例如，ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed。

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

-Name

指定要配置的应用的名称。

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

-NewName

使用此参数重命名应用。 长度不得超过 256 个字符。

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

-OptionalReference

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

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

-Owner

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

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

-PassThru

添加此参数可返回一个对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。

类型:SwitchParameter
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

-RemoveAppCatalog

指定语言 ID 数组以删除关联的软件中心条目。 若要删除所有条目，请使用 ClearAppCatalog 参数。

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

例如，删除 爱尔兰 (爱尔兰) 的本地化软件中心条目：

-RemoveAppCatalog 2108

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

-RemoveAppCategoryName

指定要删除的管理类别名称的数组。 若要删除所有管理类别，请使用 CleanAppCategory 参数。

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

-RemoveOwner

指定要删除的所有者数组。 若要删除所有所有者，请使用 ClearOwner 参数。

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

-RemoveSupportContact

指定要删除的支持联系人的数组。 若要删除所有支持联系人，请使用 ClearSupportContact 参数。

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

-RemoveUserCategoryName

指定要删除的用户类别名称的数组。 若要删除所有用户类别，请使用 CleanUserCategory 参数。

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

-SendToProtectedDistributionPoint

指示是否将此应用程序复制到受保护的分发点。

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

-SoftwareVersion

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

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

-SupportContact

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

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

-UserCategory

此参数已弃用，请使用 -AddUserCategory。

类型:String[]
别名:UserCategories
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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

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