Set-CMClientSettingSoftwareCenter

Модуль:

ConfigurationManager

Используйте этот командлет для настройки параметров клиента в группе Центр программного обеспечения .

Синтаксис

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

Описание

Используйте этот командлет для настройки параметров клиента в группе Центр программного обеспечения .

Примечание.

Командлеты Configuration Manager должны выполняться с диска сайта 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. Изменение порядка вкладок

# 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[]
Aliases:	AddCustomTabs
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ClearCustomTab

Этот параметр используется для удаления настраиваемой вкладки из параметра клиента Центра программного обеспечения.

Тип:	SwitchParameter
Aliases:	ClearAllCustomTabs
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ColorScheme

Используйте этот параметр для настройки параметра клиента Центра программного обеспечения Цветовая схема для центра программного обеспечения. Пример объекта color для: Red=255, Green=74, Blue=74: $colorObject = [system.drawing.color]::FromArgb(255;255;74;74)

Тип:	Color
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CompanyName

Используйте этот параметр для настройки параметра клиента Центра программного обеспечения название компании.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CustomTabName

Этот параметр не рекомендуется использовать. Чтобы создать пользовательскую вкладку, используйте командлет New-CMSoftwareCenterTabItem .

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CustomTabUrl

Этот параметр не рекомендуется использовать. Чтобы создать пользовательскую вкладку, используйте командлет New-CMSoftwareCenterTabItem .

Тип:	Uri
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultSetting

Этот параметр применяет параметры к параметру клиента по умолчанию. Используйте параметр -Name для любого настраиваемого параметра клиента.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnableApplicationsTab

Используйте этот параметр, чтобы отобразить или скрыть вкладку Приложения по умолчанию в Центре программного обеспечения.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnableComplianceTab

Используйте этот параметр для отображения или скрытия вкладки соответствия устройств по умолчанию в Центре программного обеспечения.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnableCustomize

Этот параметр включает настраиваемые параметры центра программного обеспечения. Например, цветовая схема или логотип.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnableOperatingSystemsTab

Используйте этот параметр для отображения или скрытия вкладки Операционные системы по умолчанию в Центре программного обеспечения.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnableOptionsTab

Используйте этот параметр для отображения или скрытия вкладки Параметры по умолчанию в Центре программного обеспечения.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnableStatusTab

Этот параметр используется для отображения или скрытия вкладки Состояние установки по умолчанию в Центре программного обеспечения.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnableUpdatesTab

Используйте этот параметр, чтобы отобразить или скрыть вкладку Обновления по умолчанию в Центре программного обеспечения.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-HideApplicationCatalogLink

Используйте этот параметр, чтобы включить или отключить следующий параметр клиента в группе Центра программного обеспечения : Скрыть ссылку каталога приложений в Центре программного обеспечения

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-HideInstalledApplication

Используйте этот параметр, чтобы включить или отключить следующий параметр клиента в группе Центра программного обеспечения : Скрытие установленных приложений в Центре программного обеспечения

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-HideUnapprovedApplication

Используйте этот параметр, чтобы включить или отключить следующий параметр клиента в группе Центра программного обеспечения : Скрытие неутвержденных приложений в Центре программного обеспечения

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

Объект Get-CMClientSetting

Тип:	IResultObject
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-LogoFilePath

Используйте этот параметр, чтобы указать путь к файлу к изображению, которое будет отображаться в качестве логотипа в Центре программного обеспечения.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MoveSelectedTabToIndex

Используйте этот параметр для изменения порядка вкладок в Центре программного обеспечения. Укажите целое число для позиции с 0 вверху. Используйте один из следующих параметров, чтобы выбрать вкладку для перемещения: SelectCustomTabName, SelectBuiltInTab, SelectTabIndex.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Name

Используйте этот параметр, чтобы указать параметр клиента по его имени.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PassThru

Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RemoveCustomTabName

Укажите имя настраиваемой вкладки, удаляемой из параметра клиента. Можно задать одно или несколько имен.

Тип:	String[]
Aliases:	RemoveCustomTabNames
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SelectBuiltInTab

Используйте этот параметр, чтобы выбрать одну из встроенных вкладок в Центре программного обеспечения. Используйте один из следующих параметров в той же команде, чтобы изменить конфигурацию вкладки: MoveSelectedTabToIndex, SelectedTabNewName, SelectedTabNewUrl.

Тип:	BuiltInTab
Допустимые значения:	AvailableSoftware, Updates, Osd, InstallationStatus, Compliance, Options
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SelectCustomTabName

Используйте этот параметр для выбора по имени настраиваемой вкладки в Центре программного обеспечения. Используйте один из следующих параметров в той же команде, чтобы изменить конфигурацию вкладки: MoveSelectedTabToIndex, SelectedTabNewName, SelectedTabNewUrl.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SelectedTabNewName

В той же команде при выборе вкладки используйте этот параметр, чтобы изменить имя вкладки.

Тип:	String
Aliases:	SelectedCustomTabNewName
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SelectedTabNewUrl

В той же команде при выборе вкладки используйте этот параметр, чтобы изменить URL-адрес вкладки.

Тип:	Uri
Aliases:	SelectedCustomTabNewUrl
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SelectTabIndex

Используйте этот параметр для выбора вкладки по порядку в Центре программного обеспечения. Укажите целое число для позиции с 0 вверху. Используйте один из следующих параметров в той же команде, чтобы изменить конфигурацию вкладки: MoveSelectedTabToIndex, SelectedTabNewName, SelectedTabNewUrl.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SetInvisibleTabName

Этот параметр используется для скрытия настраиваемой вкладки на основе ее имени. Можно указать одну или несколько вкладок.

Тип:	String[]
Aliases:	SetInvisibleCustomTabNames
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SetVisibleTabName

Используйте этот параметр для отображения настраиваемой вкладки на основе ее имени. Можно указать одну или несколько вкладок.

Тип:	String[]
Aliases:	SetVisibleCustomTabNames
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object

Связанные ссылки

• Сведения о параметрах клиента — Центр программного обеспечения
• План для Центра программного обеспечения