Edit

Share via

Set-CMClientSettingSoftwareCenter

Module:
ConfigurationManager Module

Use this cmdlet to configure the client settings in the Software Center group.

Syntax

SetCustomSettingByName (Default) 

Set-CMClientSettingSoftwareCenter
    -Name <String>
    [-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[]>]
    [-PassThru]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetDefaultSetting 

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>]

SetCustomSettingByValue 

Set-CMClientSettingSoftwareCenter
    -InputObject <IResultObject>
    [-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[]>]
    [-PassThru]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Use this cmdlet to configure the client settings in the Software Center group.

Note

Configuration Manager cmdlets must be run from the Configuration Manager site drive. For more information, see the getting started documentation.

Examples

Example 1: Add custom tabs

Add five custom tab instances:

$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)

Example 2: Hide a tab

Set a custom tab to invisible by name:

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

Example 3: Remove a tab

Remove a custom tab by name:

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

Example 4: Show a hidden tab

Set a custom tab to visible by name:

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

Example 5: Change tab order

# 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

Example 6: Change tab properties

Modify a custom tab's name and Url by name:

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

Example 7: Remove custom tabs

Clean up all custom tabs from the client setting:

Set-CMClientSettingSoftwareCenter -DefaultSetting -ClearCustomTab

Parameters

-AddCustomTab

Use this parameter to add a custom tab to the Software Center client setting.

Parameter properties

Type:

SoftwareCenterTabItem[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:AddCustomTabs

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ClearCustomTab

Use this parameter to remove a custom tab from the Software Center client setting.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:ClearAllCustomTabs

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ColorScheme

Use this parameter to configure the Software Center client setting, Color scheme for Software Center. Example color object for: Red=255, Green=74, Blue=74: $colorObject = [system.drawing.color]::FromArgb(255,255,74,74)

Parameter properties

Type:Color
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CompanyName

Use this parameter to configure the Software Center client setting, Company name.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CustomTabName

This parameter is deprecated. To create a custom tab, use the New-CMSoftwareCenterTabItem cmdlet.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CustomTabUrl

This parameter is deprecated. To create a custom tab, use the New-CMSoftwareCenterTabItem cmdlet.

Parameter properties

Type:Uri
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DefaultSetting

This parameter will apply settings to the default client setting. Use parameter -Name for any custom client setting.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SetDefaultSetting
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableApplicationsTab

Use this parameter to show or hide the default Applications tab in Software Center.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableComplianceTab

Use this parameter to show or hide the default Device Compliance tab in Software Center.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableCustomize

This parameter will enable custom Software Center settings. Like the color scheme or a logo.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableOperatingSystemsTab

Use this parameter to show or hide the default Operating Systems tab in Software Center.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableOptionsTab

Use this parameter to show or hide the default Options tab in Software Center.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableStatusTab

Use this parameter to show or hide the default Installation Status tab in Software Center.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableUpdatesTab

Use this parameter to show or hide the default Updates tab in Software Center.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-HideApplicationCatalogLink

Use this parameter to enable or disable the following client setting in the Software Center group: Hide Application Catalog link in Software Center

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False
(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-HideInstalledApplication

Use this parameter to enable or disable the following client setting in the Software Center group: Hide installed applications in Software Center

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-HideUnapprovedApplication

Use this parameter to enable or disable the following client setting in the Software Center group: Hide unapproved applications in Software Center

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

Object of Get-CMClientSetting

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SetCustomSettingByValue
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-LogoFilePath

Use this parameter to specify the file path to an image to display as the logo in Software Center.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MoveSelectedTabToIndex

Use this parameter to change the order of tabs in Software Center. Specify an integer for position, with 0 at the top. Use one of the following parameters to select the tab to move: SelectCustomTabName, SelectBuiltInTab, SelectTabIndex.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Use this parameter to specify a client setting by its name.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SetCustomSettingByName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PassThru

Add this parameter to return an object that represents the item with which you're working. By default, this cmdlet may not generate any output.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RemoveCustomTabName

Specify the name of a custom tab to remove from the client setting. You can set one or more names.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:RemoveCustomTabNames

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SelectBuiltInTab

Use this parameter to select one of the built-in tabs in Software Center. Use one of the following parameters in the same command to change the tab's configuration: MoveSelectedTabToIndex, SelectedTabNewName, SelectedTabNewUrl.

Parameter properties

Type:BuiltInTab
Default value:None
Accepted values:AvailableSoftware, Updates, Osd, InstallationStatus, Compliance, Options
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SelectCustomTabName

Use this parameter to select by name a custom tab in Software Center. Use one of the following parameters in the same command to change the tab's configuration: MoveSelectedTabToIndex, SelectedTabNewName, SelectedTabNewUrl.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SelectedTabNewName

In the same command when you select a tab, use this parameter to change the name of the tab.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:SelectedCustomTabNewName

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SelectedTabNewUrl

In the same command when you select a tab, use this parameter to change the URL of the tab.

Parameter properties

Type:Uri
Default value:None
Supports wildcards:False
DontShow:False
Aliases:SelectedCustomTabNewUrl

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SelectTabIndex

Use this parameter to select a tab by order in Software Center. Specify an integer for position, with 0 at the top. Use one of the following parameters in the same command to change the tab's configuration: MoveSelectedTabToIndex, SelectedTabNewName, SelectedTabNewUrl.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SetInvisibleTabName

Use this parameter to hide a custom tab based upon its name. You can specify one or more tabs.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:SetInvisibleCustomTabNames

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SetVisibleTabName

Use this parameter to show a custom tab based upon its name. You can specify one or more tabs.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:SetVisibleCustomTabNames

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

System.Object