Set-CMClientSettingSoftwareCenter

使用此 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

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

类型: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 。 使用以下参数之一选择要移动的选项卡: SelectCustomTabNameSelectBuiltInTabSelectTabIndex

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

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

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

-SelectCustomTabName

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

类型: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 。 在同一命令中使用以下参数之一更改选项卡的配置: MoveSelectedTabToIndexSelectedTabNewNameSelectedTabNewUrl

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