Freigeben über

New-CMClientSetting

  • Referenz
Modul:
ConfigurationManager

Erstellt angepasste Clienteinstellungen.

Syntax

New-CMClientSetting
   [-Description <String>]
   -Name <String>
   -Type <Types>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-CMClientSetting erstellt eine Sammlung benutzerdefinierter Einstellungen für Configuration Manager-Clientcomputer. Nachdem Sie die benutzerdefinierten Einstellungen erstellt und in Clientcomputersammlungen bereitgestellt haben, setzen die benutzerdefinierten Einstellungen die Standardclienteinstellungen für diese Sammlung außer Kraft.

Weitere Informationen zu Clienteinstellungen finden Sie unter Informationen zu Clienteinstellungen in Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Erstellen einer benutzerdefinierten Sammlung von Clienteinstellungen

PS XYZ:\> New-CMClientSetting -Name "Win08ClientSettings" -Description "Windows 8 Client Computers Settings" -Type 1
AgentConfigurations: {}
AssignmentCount:     0
CreatedBy:           Contoso\DChew
DateCreated:         8/04/2012 4:40:03 PM
DateModified:        8/04/2012 4:40:03 PM
Description:         Windows 8 Client Computers Settings
Enabled:             False
FeatureType:         1
Flags:               0
LastModifiedBy:      Contoso\DChew
Name:                Win08ClientSettings
Priority:            0
SecuredScopeNames:   {Default}
Settings ID:         16777220
Type:                1
UniqueID:            {0CCA6700-AE5E-4949-8FBC-AA6719775CC3}

Dieser Befehl erstellt benutzerdefinierte Geräteeinstellungen für die Gruppe von Clientcomputern, auf denen Windows 8 ausgeführt wird. Nachdem die neue Sammlung von Einstellungen erstellt wurde, zeigt der Befehl eine nicht aufgefüllte Liste von Einstellungseigenschaften an. Verwenden Sie Get-CMClientSetting, um eine aufgefüllte Liste von Eigenschaften zu aktualisieren und anzuzeigen. Die Ausgabe für dieses Beispiel zeigt eine aufgefüllte Liste.

Parameter

-Confirm

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

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

-Description

Gibt eine Beschreibung des Inhalts der neuen Einstellungen an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
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

-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

-Name

Gibt einen Namen für benutzerdefinierte Clienteinstellungen an.

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

-Type

Gibt den Typ der benutzerdefinierten Einstellungen an. Gültige Werte sind: 1 (Gerät) oder 2 (Benutzer).

Typ:Types
Zulässige Werte:Default, Device, User
Position:Named
Standardwert:None
Erforderlich:True
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:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject