Freigeben über


Set-CMClientSettingSoftwareCenter

Verwenden Sie dieses Cmdlet, um die Clienteinstellungen in der Gruppe Softwarecenter zu konfigurieren.

Syntax

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

Beschreibung

Verwenden Sie dieses Cmdlet, um die Clienteinstellungen in der Gruppe Softwarecenter zu konfigurieren.

Hinweis

Configuration Manager Cmdlets müssen auf dem Configuration Manager-Standortlaufwerk ausgeführt werden. Weitere Informationen finden Sie in der Dokumentation zu den ersten Schritten .

Beispiele

Beispiel 1: Hinzufügen von benutzerdefinierten Registerkarten

Fügen Sie fünf benutzerdefinierte Registerkarteninstanzen hinzu:

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

Beispiel 2: Ausblenden einer Registerkarte

Legen Sie eine benutzerdefinierte Registerkarte anhand des Namens auf unsichtbar fest:

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

Beispiel 3: Entfernen einer Registerkarte

Entfernen Sie eine benutzerdefinierte Registerkarte anhand des Namens:

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

Beispiel 4: Anzeigen einer ausgeblendeten Registerkarte

Legen Sie eine benutzerdefinierte Registerkarte so fest, dass sie anhand des Namens sichtbar ist:

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

Beispiel 5: Ändern der Aktivierreihenfolge

# 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

Beispiel 6: Ändern von Registerkarteneigenschaften

Ändern Sie den Namen und die URL einer benutzerdefinierten Registerkarte anhand des Namens:

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

Beispiel 7: Entfernen von benutzerdefinierten Registerkarten

Bereinigen Sie alle benutzerdefinierten Registerkarten aus der Clienteinstellung:

Set-CMClientSettingSoftwareCenter -DefaultSetting -ClearCustomTab

Parameter

-AddCustomTab

Verwenden Sie diesen Parameter, um der Softwarecenter-Clienteinstellung eine benutzerdefinierte Registerkarte hinzuzufügen.

Typ:SoftwareCenterTabItem[]
Aliase:AddCustomTabs
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ClearCustomTab

Verwenden Sie diesen Parameter, um eine benutzerdefinierte Registerkarte aus der Clienteinstellung des Softwarecenters zu entfernen.

Typ:SwitchParameter
Aliase:ClearAllCustomTabs
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ColorScheme

Verwenden Sie diesen Parameter, um die Softwarecenter-Clienteinstellung Farbschema für Softwarecenter zu konfigurieren. Beispielfarbobjekt für: Red=255, Green=74, Blue=74: $colorObject = [system.drawing.color]::FromArgb(255,255,74,74)

Typ:Color
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CompanyName

Verwenden Sie diesen Parameter, um die Softwarecenter-Clienteinstellung Firmenname zu konfigurieren.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CustomTabName

Dieser Parameter ist veraltet. Verwenden Sie zum Erstellen einer benutzerdefinierten Registerkarte das Cmdlet New-CMSoftwareCenterTabItem .

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CustomTabUrl

Dieser Parameter ist veraltet. Verwenden Sie zum Erstellen einer benutzerdefinierten Registerkarte das Cmdlet New-CMSoftwareCenterTabItem .

Typ:Uri
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultSetting

Dieser Parameter wendet Einstellungen auf die Standardclienteinstellung an. Verwenden Sie den Parameter -Name für jede benutzerdefinierte Clienteinstellung.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableApplicationsTab

Verwenden Sie diesen Parameter, um die Standardregisterkarte Anwendungen im Softwarecenter ein- oder auszublenden.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableComplianceTab

Verwenden Sie diesen Parameter, um die Standardregisterkarte Gerätekonformität im Softwarecenter ein- oder auszublenden.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableCustomize

Dieser Parameter aktiviert benutzerdefinierte Softwarecentereinstellungen. Wie das Farbschema oder ein Logo.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableOperatingSystemsTab

Verwenden Sie diesen Parameter, um die Standardregisterkarte Betriebssysteme im Softwarecenter ein- oder auszublenden.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableOptionsTab

Verwenden Sie diesen Parameter, um die Standardregisterkarte Optionen im Softwarecenter ein- oder auszublenden.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableStatusTab

Verwenden Sie diesen Parameter, um die Standardregisterkarte "Installationsstatus " im Softwarecenter ein- oder auszublenden.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableUpdatesTab

Verwenden Sie diesen Parameter, um die Standardregisterkarte Aktualisierungen im Softwarecenter ein- oder auszublenden.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Verwenden Sie diesen Parameter, um die folgende Clienteinstellung in der Gruppe Softwarecenter zu aktivieren oder zu deaktivieren: Link anwendungskatalog im Softwarecenter ausblenden

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HideInstalledApplication

Verwenden Sie diesen Parameter, um die folgende Clienteinstellung in der Gruppe Softwarecenter zu aktivieren oder zu deaktivieren: Installierte Anwendungen im Softwarecenter ausblenden

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HideUnapprovedApplication

Verwenden Sie diesen Parameter, um die folgende Clienteinstellung in der Gruppe Softwarecenter zu aktivieren oder zu deaktivieren: Nicht genehmigte Anwendungen im Softwarecenter ausblenden

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Objekt von Get-CMClientSetting

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LogoFilePath

Verwenden Sie diesen Parameter, um den Dateipfad zu einem Bild anzugeben, das als Logo im Softwarecenter angezeigt werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MoveSelectedTabToIndex

Verwenden Sie diesen Parameter, um die Reihenfolge der Registerkarten im Softwarecenter zu ändern. Geben Sie eine ganze Zahl für die Position mit 0 oben an. Verwenden Sie einen der folgenden Parameter, um die zu verschiebende Registerkarte auszuwählen: SelectCustomTabName, SelectBuiltInTab, SelectTabIndex.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Verwenden Sie diesen Parameter, um eine Clienteinstellung anhand ihres Namens anzugeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveCustomTabName

Geben Sie den Namen einer benutzerdefinierten Registerkarte an, die aus der Clienteinstellung entfernt werden soll. Sie können einen oder mehrere Namen festlegen.

Typ:String[]
Aliase:RemoveCustomTabNames
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SelectBuiltInTab

Verwenden Sie diesen Parameter, um eine der integrierten Registerkarten im Softwarecenter auszuwählen. Verwenden Sie einen der folgenden Parameter im selben Befehl, um die Konfiguration der Registerkarte zu ändern: MoveSelectedTabToIndex, SelectedTabNewName, SelectedTabNewUrl.

Typ:BuiltInTab
Zulässige Werte:AvailableSoftware, Updates, Osd, InstallationStatus, Compliance, Options
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SelectCustomTabName

Verwenden Sie diesen Parameter, um eine benutzerdefinierte Registerkarte im Softwarecenter anhand des Namens auszuwählen. Verwenden Sie einen der folgenden Parameter im selben Befehl, um die Konfiguration der Registerkarte zu ändern: MoveSelectedTabToIndex, SelectedTabNewName, SelectedTabNewUrl.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SelectedTabNewName

Verwenden Sie im gleichen Befehl, wenn Sie eine Registerkarte auswählen, diesen Parameter, um den Namen der Registerkarte zu ändern.

Typ:String
Aliase:SelectedCustomTabNewName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SelectedTabNewUrl

Verwenden Sie im selben Befehl, wenn Sie eine Registerkarte auswählen, diesen Parameter, um die URL der Registerkarte zu ändern.

Typ:Uri
Aliase:SelectedCustomTabNewUrl
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SelectTabIndex

Verwenden Sie diesen Parameter, um eine Registerkarte nach Reihenfolge im Softwarecenter auszuwählen. Geben Sie eine ganze Zahl für die Position mit 0 oben an. Verwenden Sie einen der folgenden Parameter im selben Befehl, um die Konfiguration der Registerkarte zu ändern: MoveSelectedTabToIndex, SelectedTabNewName, SelectedTabNewUrl.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SetInvisibleTabName

Verwenden Sie diesen Parameter, um eine benutzerdefinierte Registerkarte basierend auf ihrem Namen auszublenden. Sie können eine oder mehrere Registerkarten angeben.

Typ:String[]
Aliase:SetInvisibleCustomTabNames
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SetVisibleTabName

Verwenden Sie diesen Parameter, um eine benutzerdefinierte Registerkarte basierend auf ihrem Namen anzuzeigen. Sie können eine oder mehrere Registerkarten angeben.

Typ:String[]
Aliase:SetVisibleCustomTabNames
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object