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 cmdlet 必须从Configuration Manager站点驱动器运行。 有关详细信息，请参阅 入门 文档。

示例

示例 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

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

Type:SoftwareCenterTabItem[]
Aliases:AddCustomTabs
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearCustomTab

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

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

-ColorScheme

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

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

-CompanyName

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

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

-Confirm

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

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

-CustomTabName

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

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

-CustomTabUrl

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

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

-DefaultSetting

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

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

-DisableWildcardHandling

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

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

-EnableApplicationsTab

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

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

-EnableComplianceTab

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

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

-EnableCustomize

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

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

-EnableOperatingSystemsTab

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

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

-EnableOptionsTab

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

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

-EnableStatusTab

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

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

-EnableUpdatesTab

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

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

-ForceWildcardHandling

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

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

-HideApplicationCatalogLink

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

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

-HideInstalledApplication

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

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

-HideUnapprovedApplication

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

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

-InputObject

Get-CMClientSetting 的对象

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LogoFilePath

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

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

-MoveSelectedTabToIndex

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

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

-Name

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

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

-PassThru

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

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

-RemoveCustomTabName

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

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

-SelectBuiltInTab

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

Type:BuiltInTab
Accepted values:AvailableSoftware, Updates, Osd, InstallationStatus, Compliance, Options
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SelectCustomTabName

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

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

-SelectedTabNewName

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

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

-SelectedTabNewUrl

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

Type:Uri
Aliases:SelectedCustomTabNewUrl
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SelectTabIndex

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

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

-SetInvisibleTabName

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

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

-SetVisibleTabName

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

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

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object