Compartilhar via


Set-CMClientSettingSoftwareCenter

Utilize este cmdlet para configurar as definições de cliente no grupo Centro de Software .

Sintaxe

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

Description

Utilize este cmdlet para configurar as definições de cliente no grupo Centro de Software .

Observação

Os cmdlets do Configuration Manager têm de ser executados a partir da unidade do site do Configuration Manager. Para obter mais informações, veja a documentação de introdução .

Exemplos

Exemplo 1: Adicionar separadores personalizados

Adicionar cinco instâncias de separador personalizadas:

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

Exemplo 2: Ocultar um separador

Defina um separador personalizado como invisível pelo nome:

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

Exemplo 3: Remover um separador

Remover um separador personalizado pelo nome:

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

Exemplo 4: Mostrar um separador oculto

Defina um separador personalizado para visível pelo nome:

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

Exemplo 5: Alterar a ordem dos separadores

# 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

Exemplo 6: Alterar as propriedades do separador

Modifique o nome de um separador personalizado e o URL pelo nome:

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

Exemplo 7: Remover separadores personalizados

Limpe todos os separadores personalizados da definição de cliente:

Set-CMClientSettingSoftwareCenter -DefaultSetting -ClearCustomTab

Parâmetros

-AddCustomTab

Utilize este parâmetro para adicionar um separador personalizado à definição de cliente do Centro de Software.

Tipo:SoftwareCenterTabItem[]
Aliases:AddCustomTabs
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClearCustomTab

Utilize este parâmetro para remover um separador personalizado da definição de cliente do Centro de Software.

Tipo:SwitchParameter
Aliases:ClearAllCustomTabs
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ColorScheme

Utilize este parâmetro para configurar a definição de cliente do Centro de Software, Esquema de cores para o Centro de Software. Objeto de cor de exemplo para: Vermelho=255, Verde=74, Azul=74: $colorObject = [system.drawing.color]::FromArgb(255,255,74,74)

Tipo:Color
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CompanyName

Utilize este parâmetro para configurar a definição de cliente do Centro de Software, Nome da empresa.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CustomTabName

Este parâmetro foi preterido. Para criar um separador personalizado, utilize o cmdlet New-CMSoftwareCenterTabItem .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CustomTabUrl

Este parâmetro foi preterido. Para criar um separador personalizado, utilize o cmdlet New-CMSoftwareCenterTabItem .

Tipo:Uri
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultSetting

Este parâmetro aplicará definições à predefinição do cliente. Utilize o parâmetro -Name para qualquer definição de cliente personalizada.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableApplicationsTab

Utilize este parâmetro para mostrar ou ocultar o separador Aplicações predefinido no Centro de Software.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableComplianceTab

Utilize este parâmetro para mostrar ou ocultar o separador Predefinido de Conformidade do Dispositivo no Centro de Software.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableCustomize

Este parâmetro ativará as definições personalizadas do Centro de Software. Como o esquema de cores ou um logótipo.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableOperatingSystemsTab

Utilize este parâmetro para mostrar ou ocultar o separador Sistemas Operativos predefinido no Centro de Software.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableOptionsTab

Utilize este parâmetro para mostrar ou ocultar o separador Opções predefinido no Centro de Software.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableStatusTab

Utilize este parâmetro para mostrar ou ocultar o separador Estado da Instalação predefinido no Centro de Software.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableUpdatesTab

Utilize este parâmetro para mostrar ou ocultar o separador Atualizações predefinido no Centro de Software.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Utilize este parâmetro para ativar ou desativar a seguinte definição de cliente no grupo Centro de Software : Ocultar ligação catálogo de aplicações no Centro de Software

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-HideInstalledApplication

Utilize este parâmetro para ativar ou desativar a seguinte definição de cliente no grupo Centro de Software : Ocultar aplicações instaladas no Centro de Software

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-HideUnapprovedApplication

Utilize este parâmetro para ativar ou desativar a seguinte definição de cliente no grupo Centro de Software : Ocultar aplicações não aprovadas no Centro de Software

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Objeto de Get-CMClientSetting

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LogoFilePath

Utilize este parâmetro para especificar o caminho do ficheiro para uma imagem a apresentar como logótipo no Centro de Software.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MoveSelectedTabToIndex

Utilize este parâmetro para alterar a ordem dos separadores no Centro de Software. Especifique um número inteiro para a posição, com 0 na parte superior. Utilize um dos seguintes parâmetros para selecionar o separador a mover: SelectCustomTabName, SelectBuiltInTab, SelectTabIndex.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Utilize este parâmetro para especificar uma definição de cliente pelo respetivo nome.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveCustomTabName

Especifique o nome de um separador personalizado a remover da definição de cliente. Pode definir um ou mais nomes.

Tipo:String[]
Aliases:RemoveCustomTabNames
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SelectBuiltInTab

Utilize este parâmetro para selecionar um dos separadores incorporados no Centro de Software. Utilize um dos seguintes parâmetros no mesmo comando para alterar a configuração do separador: MoveSelectedTabToIndex, SelectedTabNewName, SelectedTabNewUrl.

Tipo:BuiltInTab
Valores aceitos:AvailableSoftware, Updates, Osd, InstallationStatus, Compliance, Options
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SelectCustomTabName

Utilize este parâmetro para selecionar por nome um separador personalizado no Centro de Software. Utilize um dos seguintes parâmetros no mesmo comando para alterar a configuração do separador: MoveSelectedTabToIndex, SelectedTabNewName, SelectedTabNewUrl.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SelectedTabNewName

No mesmo comando quando seleciona um separador, utilize este parâmetro para alterar o nome do separador.

Tipo:String
Aliases:SelectedCustomTabNewName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SelectedTabNewUrl

No mesmo comando quando seleciona um separador, utilize este parâmetro para alterar o URL do separador.

Tipo:Uri
Aliases:SelectedCustomTabNewUrl
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SelectTabIndex

Utilize este parâmetro para selecionar um separador por ordem no Centro de Software. Especifique um número inteiro para a posição, com 0 na parte superior. Utilize um dos seguintes parâmetros no mesmo comando para alterar a configuração do separador: MoveSelectedTabToIndex, SelectedTabNewName, SelectedTabNewUrl.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SetInvisibleTabName

Utilize este parâmetro para ocultar um separador personalizado com base no respetivo nome. Pode especificar um ou mais separadores.

Tipo:String[]
Aliases:SetInvisibleCustomTabNames
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SetVisibleTabName

Utilize este parâmetro para mostrar um separador personalizado com base no respetivo nome. Pode especificar um ou mais separadores.

Tipo:String[]
Aliases:SetVisibleCustomTabNames
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object