Freigeben über

Start-CMClientSettingDeployment

  • Referenz
Modul:
ConfigurationManager

(Veraltet) Stellt Clienteinstellungen auf Geräten in einer Sammlung bereit.

Syntax

Start-CMClientSettingDeployment
     -ClientSettingName <String>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSetting <IResultObject>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSetting <IResultObject>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSetting <IResultObject>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingId <String>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingId <String>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingId <String>
     -Collection <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingName <String>
     -CollectionId <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMClientSettingDeployment
     -ClientSettingName <String>
     -CollectionName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Das Cmdlet Start-CMClientSettingDeployment stellt Clienteinstellungen für Geräte in einer Configuration Manager-Sammlung bereit. Geben Sie das Clienteinstellungsobjekt mithilfe seines Namens oder seiner ID an, oder Sie können das Cmdlet Get-CMClientSetting verwenden, um ein Clienteinstellungsobjekt abzurufen. Geben Sie die Sammlung an, auf die die Einstellungen angewendet werden sollen, mithilfe ihres Namens oder ihrer ID, oder Sie können das Cmdlet Get-CMDeviceCollection verwenden, um eine Gerätesammlung abzurufen.

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

Wichtig

Ab Version 2107 ist dieses Cmdlet veraltet und kann in einer zukünftigen Version entfernt werden. Verwenden Sie stattdessen das Cmdlet New-CMClientSettingDeployment .

Beispiele

Beispiel 1: Bereitstellen eines Clienteinstellungsobjekts mithilfe seiner ID in einer benannten Auflistung

PS XYZ:\> Start-CMClientSettingDeployment -ClientSettingId "CSI1023" -CollectionName "General Computer Collection"

Dieser Befehl startet die Bereitstellung des Clienteinstellungsobjekts, das über die ID CSI1023 für die Auflistung mit dem Namen Allgemeine Computersammlung verfügt.

Beispiel 2: Bereitstellen eines Clienteinstellungsobjekts mithilfe einer Variablen

PS XYZ:\> $CSID = Get-CMClientSetting -Id "CSI1023"
PS XYZ:\> Start-CMClientSettingDeployment -ClientSetting $CSID -CollectionName "General Computer Collection"

Der erste Befehl ruft ein Clienteinstellungsobjekt ab, das über die ID CSI1023 verfügt, und speichert es in der variablen $CSID.

Der zweite Befehl startet die Bereitstellung des Clienteinstellungsobjekts in der $CSID Variablen für die Auflistung mit dem Namen Allgemeine Computersammlung.

Parameter

-ClientSetting

Gibt ein Clienteinstellungsobjekt an. Verwenden Sie das Cmdlet Get-CMClientSetting , um ein Clienteinstellungsobjekt abzurufen.

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

-ClientSettingId

Gibt die ID eines Clienteinstellungsobjekts an.

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

-ClientSettingName

Gibt den Namen eines Clienteinstellungsobjekts an.

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

-Collection

Gibt ein Configuration Manager-Auflistungsobjekt an. Verwenden Sie zum Abrufen eines Auflistungsobjekts das Cmdlet Get-CMDeviceCollection . Configuration Manager wendet die Clienteinstellungen auf die Mitglieder dieser Sammlung an.

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

-CollectionId

Gibt die ID einer Configuration Manager-Sammlung an. Configuration Manager wendet die Clienteinstellungen auf die Mitglieder dieser Sammlung an.

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

-CollectionName

Gibt den Namen einer Configuration Manager-Sammlung an. Configuration Manager wendet die Clienteinstellungen auf die Mitglieder dieser Sammlung an.

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

-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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object