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.

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

-ClearCustomTab

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

Type:SwitchParameter
Aliases:ClearAllCustomTabs
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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)

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

-CompanyName

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

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

-Confirm

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

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

-CustomTabName

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

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

-CustomTabUrl

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

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

-DefaultSetting

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

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

-DisableWildcardHandling

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

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

-EnableApplicationsTab

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

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

-EnableComplianceTab

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

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

-EnableCustomize

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

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

-EnableOperatingSystemsTab

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

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

-EnableOptionsTab

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

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

-EnableStatusTab

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

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

-EnableUpdatesTab

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

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

-ForceWildcardHandling

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

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

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

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

-HideInstalledApplication

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

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

-InputObject

Objekt von Get-CMClientSetting

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

-LogoFilePath

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Aliases:RemoveCustomTabNames
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

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.

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

-SelectedTabNewName

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

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

-SelectedTabNewUrl

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

Type:Uri
Aliases:SelectedCustomTabNewUrl
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-SetInvisibleTabName

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

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

-SetVisibleTabName

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

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

-WhatIf

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

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object