Set-CMClientSettingSoftwareCenter

模块:

ConfigurationManager

使用此 cmdlet 在 软件中心 组中配置客户端设置。

语法

Set-CMClientSettingSoftwareCenter
   [-AddCustomTab <SoftwareCenterTabItem[]>]
   [-ClearCustomTab]
   [-ColorScheme <Color>]
   [-CompanyName <String>]
   [-CustomTabName <String>]
   [-CustomTabUrl <Uri>]
   [-EnableApplicationsTab <Boolean>]
   [-EnableComplianceTab <Boolean>]
   [-EnableCustomize <Boolean>]
   [-EnableOperatingSystemsTab <Boolean>]
   [-EnableOptionsTab <Boolean>]
   [-EnableStatusTab <Boolean>]
   [-EnableUpdatesTab <Boolean>]
   [-HideApplicationCatalogLink <Boolean>]
   [-HideInstalledApplication <Boolean>]
   [-HideUnapprovedApplication <Boolean>]
   [-LogoFilePath <String>]
   [-MoveSelectedTabToIndex <Int32>]
   [-RemoveCustomTabName <String[]>]
   [-SelectBuiltInTab <BuiltInTab>]
   [-SelectCustomTabName <String>]
   [-SelectedTabNewName <String>]
   [-SelectedTabNewUrl <Uri>]
   [-SelectTabIndex <Int32>]
   [-SetInvisibleTabName <String[]>]
   [-SetVisibleTabName <String[]>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSettingSoftwareCenter
   [-AddCustomTab <SoftwareCenterTabItem[]>]
   [-ClearCustomTab]
   [-ColorScheme <Color>]
   [-CompanyName <String>]
   [-CustomTabName <String>]
   [-CustomTabUrl <Uri>]
   [-EnableApplicationsTab <Boolean>]
   [-EnableComplianceTab <Boolean>]
   [-EnableCustomize <Boolean>]
   [-EnableOperatingSystemsTab <Boolean>]
   [-EnableOptionsTab <Boolean>]
   [-EnableStatusTab <Boolean>]
   [-EnableUpdatesTab <Boolean>]
   [-HideApplicationCatalogLink <Boolean>]
   [-HideInstalledApplication <Boolean>]
   [-HideUnapprovedApplication <Boolean>]
   [-LogoFilePath <String>]
   [-MoveSelectedTabToIndex <Int32>]
   [-RemoveCustomTabName <String[]>]
   [-SelectBuiltInTab <BuiltInTab>]
   [-SelectCustomTabName <String>]
   [-SelectedTabNewName <String>]
   [-SelectedTabNewUrl <Uri>]
   [-SelectTabIndex <Int32>]
   [-SetInvisibleTabName <String[]>]
   [-SetVisibleTabName <String[]>]
   [-DefaultSetting]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMClientSettingSoftwareCenter
   [-AddCustomTab <SoftwareCenterTabItem[]>]
   [-ClearCustomTab]
   [-ColorScheme <Color>]
   [-CompanyName <String>]
   [-CustomTabName <String>]
   [-CustomTabUrl <Uri>]
   [-EnableApplicationsTab <Boolean>]
   [-EnableComplianceTab <Boolean>]
   [-EnableCustomize <Boolean>]
   [-EnableOperatingSystemsTab <Boolean>]
   [-EnableOptionsTab <Boolean>]
   [-EnableStatusTab <Boolean>]
   [-EnableUpdatesTab <Boolean>]
   [-HideApplicationCatalogLink <Boolean>]
   [-HideInstalledApplication <Boolean>]
   [-HideUnapprovedApplication <Boolean>]
   [-LogoFilePath <String>]
   [-MoveSelectedTabToIndex <Int32>]
   [-RemoveCustomTabName <String[]>]
   [-SelectBuiltInTab <BuiltInTab>]
   [-SelectCustomTabName <String>]
   [-SelectedTabNewName <String>]
   [-SelectedTabNewUrl <Uri>]
   [-SelectTabIndex <Int32>]
   [-SetInvisibleTabName <String[]>]
   [-SetVisibleTabName <String[]>]
   -InputObject <IResultObject>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 在 软件中心 组中配置客户端设置。

注意

必须从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet。 有关详细信息，请参阅 入门 文档。

示例

示例 1：添加自定义选项卡

添加五个自定义选项卡实例：

$itemA = New-CMSoftwareCenterTabItem -Name "1abc" -Url "http://www.a"
$itemB = New-CMSoftwareCenterTabItem -Name "2abc" -Url "https://www.b"
$itemC = New-CMSoftwareCenterTabItem -Name "3abc" -Url "http://www.c"
$itemD = New-CMSoftwareCenterTabItem -Name "4abc" -Url "https://www.d"
$itemE = New-CMSoftwareCenterTabItem -Name "5abc" -Url "http://www.e"
Set-CMClientSettingSoftwareCenter -DefaultSetting -AddCustomTab ($itemA, $itemB, $itemC, $itemD, $itemE)

示例 2：隐藏选项卡

按名称将自定义选项卡设置为不可见：

Set-CMClientSettingSoftwareCenter -DefaultSetting -SetInvisibleTabName ("2abc","4abc", "5abc")

示例 3：删除选项卡

按名称删除自定义选项卡：

Set-CMClientSettingSoftwareCenter -DefaultSetting -RemoveCustomTabName ("3abc","4abc")

示例 4：显示隐藏选项卡

将自定义选项卡设置为按名称可见：

Set-CMClientSettingSoftwareCenter -DefaultSetting -SetVisibleTabName ("2abc", "5abc")

示例 5：更改 Tab 键顺序

# Move selected custom tab to specific position by name:
Set-CMClientSettingSoftwareCenter -DefaultSetting -SelectCustomTabName "1abc" -MoveSelectedTabToIndex 0

# Move selected built-in tab to specific position:
Set-CMClientSettingSoftwareCenter -DefaultSetting -SelectBuiltInTab AvailableSoftware -MoveSelectedTabToIndex 0

# Move selected tab to specific position by current index of position:
Set-CMClientSettingSoftwareCenter -DefaultSetting -SelectTabIndex 0 -MoveSelectedTabToIndex 1

示例 6：更改选项卡属性

按名称修改自定义选项卡的名称和 Url：

Set-CMClientSettingSoftwareCenter -DefaultSetting -SelectCustomTabName "1abc" -SelectedTabNewName "new1abc" -SelectedTabNewUrl http://www.aNew

示例 7：删除自定义选项卡

清理客户端设置中的所有自定义选项卡：

Set-CMClientSettingSoftwareCenter -DefaultSetting -ClearCustomTab

参数

-AddCustomTab

使用此参数将自定义选项卡添加到软件中心客户端设置。

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

-ClearCustomTab

使用此参数可从软件中心客户端设置中删除自定义选项卡。

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

-ColorScheme

使用此参数可配置软件中心客户端设置， 即软件中心的配色方案。 示例颜色对象：Red=255，Green=74，Blue=74： $colorObject = [system.drawing.color]：：FromArgb (255,255,74,74)

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

-CompanyName

使用此参数配置软件中心客户端设置 公司名称。

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

-Confirm

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

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

-CustomTabName

此参数已弃用。 若要创建自定义选项卡，请使用 New-CMSoftwareCenterTabItem cmdlet。

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

-CustomTabUrl

此参数已弃用。 若要创建自定义选项卡，请使用 New-CMSoftwareCenterTabItem cmdlet。

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

-DefaultSetting

此参数会将设置应用于默认客户端设置。 对任何自定义客户端设置使用参数 -Name 。

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

-DisableWildcardHandling

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

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

-EnableApplicationsTab

使用此参数可在软件中心显示或隐藏默认 的“应用程序 ”选项卡。

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

-EnableComplianceTab

使用此参数可在软件中心显示或隐藏默认 的“设备符合性 ”选项卡。

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

-EnableCustomize

此参数将启用自定义软件中心设置。 例如配色方案或徽标。

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

-EnableOperatingSystemsTab

使用此参数可在软件中心显示或隐藏默认的“ 操作系统 ”选项卡。

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

-EnableOptionsTab

使用此参数可在软件中心显示或隐藏默认 的“选项 ”选项卡。

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

-EnableStatusTab

使用此参数可在软件中心显示或隐藏默认的 “安装状态 ”选项卡。

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

-EnableUpdatesTab

使用此参数可在软件中心显示或隐藏默认的“ 更新 ”选项卡。

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

-ForceWildcardHandling

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

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

-HideApplicationCatalogLink

使用此参数在 软件中心 组中启用或禁用以下客户端设置： 在软件中心隐藏应用程序目录链接

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

-HideInstalledApplication

使用此参数在 软件中心 组中启用或禁用以下客户端设置： 在软件中心隐藏已安装的应用程序

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

-HideUnapprovedApplication

使用此参数在 软件中心 组中启用或禁用以下客户端设置： 在软件中心隐藏未批准的应用程序

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

-InputObject

Get-CMClientSetting 的对象

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

-LogoFilePath

使用此参数可指定要在软件中心显示为徽标的图像的文件路径。

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

-MoveSelectedTabToIndex

使用此参数可更改软件中心中选项卡的顺序。 为位置指定一个整数，顶部为 0 。 使用以下参数之一选择要移动的选项卡： SelectCustomTabName、 SelectBuiltInTab、 SelectTabIndex。

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

-Name

使用此参数可按名称指定客户端设置。

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

-PassThru

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

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

-RemoveCustomTabName

指定要从客户端设置中删除的自定义选项卡的名称。 可以设置一个或多个名称。

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

-SelectBuiltInTab

使用此参数在软件中心中选择一个内置选项卡。 在同一命令中使用以下参数之一更改选项卡的配置： MoveSelectedTabToIndex、 SelectedTabNewName、 SelectedTabNewUrl。

类型:	BuiltInTab
接受的值:	AvailableSoftware, Updates, Osd, InstallationStatus, Compliance, Options
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SelectCustomTabName

使用此参数可按名称选择软件中心中的自定义选项卡。 在同一命令中使用以下参数之一更改选项卡的配置： MoveSelectedTabToIndex、 SelectedTabNewName、 SelectedTabNewUrl。

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

-SelectedTabNewName

选择选项卡时，在同一命令中，使用此参数更改选项卡的名称。

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

-SelectedTabNewUrl

选择选项卡时，在同一命令中，使用此参数更改选项卡的 URL。

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

-SelectTabIndex

使用此参数在软件中心按顺序选择选项卡。 为位置指定一个整数，顶部为 0 。 在同一命令中使用以下参数之一更改选项卡的配置： MoveSelectedTabToIndex、 SelectedTabNewName、 SelectedTabNewUrl。

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

-SetInvisibleTabName

使用此参数可以根据自定义选项卡的名称隐藏该选项卡。 可以指定一个或多个选项卡。

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

-SetVisibleTabName

使用此参数可基于其名称显示自定义选项卡。 可以指定一个或多个选项卡。

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

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

• 关于客户端设置 - 软件中心
• 规划软件中心