New-CMClientSettingDeployment
Stellen Sie eine benutzerdefinierte Clienteinstellung bereit.
Syntax
New-CMClientSettingDeployment
-Name <String>
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMClientSettingDeployment
-Id <String>
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMClientSettingDeployment
-InputObject <IResultObject>
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Verwenden Sie dieses Cmdlet, um eine benutzerdefinierte Clienteinstellung bereitzustellen. Wenn Sie benutzerdefinierte Einstellungen bereitstellen, überschreiben sie die Standardclienteinstellungen. Benutzerdefinierte Clienteinstellungen mit einer höheren Priorität können auch andere Einstellungen überschreiben. Weitere Informationen finden Sie unter Erstellen und Bereitstellen benutzerdefinierter Clienteinstellungen.
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: Bereitstellen eines Clienteinstellungsobjekts mithilfe seiner ID in einer benannten Auflistung
New-CMClientSettingDeployment -Id "16777225" -CollectionName "General Computer Collection"
Parameter
-Collection
Geben Sie ein Auflistungsobjekt als Ziel für die Bereitstellung an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMCollection .
Typ: | IResultObject |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-CollectionId
Geben Sie eine ID für die Sammlung für diese Bereitstellung an. Dieser Wert ist eine Standardsammlungs-ID, XYZ00042
z. B. .
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-CollectionName
Geben Sie einen Sammlungsnamen für diese Bereitstellung an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | True |
-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 |
-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 |
-Id
Geben Sie die ID der bereitzustellenden benutzerdefinierten Clienteinstellungen an. Diese ID ist die Einstellungs-ID in der Konsole und die Eigenschaft SettingsID für die SMS_ClientSettings WMI-Klasse.
Sie können das Cmdlet Get-CMClientSetting verwenden, um diese Eigenschaft abzurufen. Beispiel: (Get-CMClientSetting -Name "Remote control").SettingsID
Typ: | String |
Aliase: | ClientSettingId |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-InputObject
Geben Sie ein benutzerdefiniertes Clienteinstellungsobjekt an, das bereitgestellt werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMClientSetting .
Typ: | IResultObject |
Aliase: | ClientSetting |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Name
Geben Sie den Namen der bereitzustellenden benutzerdefinierten Clienteinstellungen an.
Typ: | String |
Aliase: | ClientSettingName |
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: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object