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 auf Geräten 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 mit der ID CSI1023 ab und speichert es in der variablen $CSID.

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

Parameter

-ClientSetting

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

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

-ClientSettingId

Gibt die ID eines Clienteinstellungsobjekts an.

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

-ClientSettingName

Gibt den Namen eines Clienteinstellungsobjekts an.

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

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

-CollectionId

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

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

-CollectionName

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

Type:String
Position:Named
Default value:None
Required:True
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:False
Required:False
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

-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

-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:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object