Freigeben über

New-CMSettingDeployment

  • Referenz
Modul:
ConfigurationManager

Stellen Sie ein Einstellungsrichtlinienobjekt für eine Auflistung bereit.

Syntax

New-CMSettingDeployment
   [-CMSetting] <CMSettings>
   [-Schedule <IResultObject>]
   [-OverrideServiceWindows]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Stellen Sie ein Einstellungsrichtlinienobjekt für eine Auflistung bereit. Stellen Sie beispielsweise eine BitLocker-Verwaltungsrichtlinie oder eine Microsoft Defender-Anwendungssteuerungsrichtlinie bereit. Verwenden Sie zum Erstellen eines benutzerdefinierten Zeitplans das Cmdlet New-CMSchedule . Verwenden Sie zum Abrufen einer Sammlung das Cmdlet Get-CMCollection .

Beispiele

Beispiel 1: Bereitstellen eines BitLocker-Verwaltungsobjekts für alle Desktop- und Serverclients

In diesem Beispiel wird ein BitLocker-Verwaltungseinstellungsobjekt anhand des Namens abgerufen und in der variablen $setting gespeichert. Anschließend ruft sie eine Auflistung anhand des Namens ab und speichert dieses Objekt in der $collection Variablen. Es verwendet das Cmdlet New-CMSettingDeployment , um das BitLocker-Verwaltungseinstellungsobjekt in dieser Sammlung bereitzustellen.

$setting = Get-CMBlmSetting -Name "My BitLocker settings"

$collection = Get-CMCollection -Name "All Desktop and Server Clients"

New-CMSettingDeployment -CMSetting $setting -CollectionName $collection.Name

Beispiel 2: Bereitstellen einer Windows Defender-Anwendungssteuerungseinstellung mithilfe eines benutzerdefinierten Zeitplans

In diesem Beispiel wird auch ein benutzerdefinierter Zeitplan mit dem Cmdlet New-CMSchedule erstellt.

$setting = Get-CMWdacSetting -Name "My App Control settings"

$collection = Get-CMCollection -Name "All Desktop and Server Clients"

$sched = New-CMSchedule -Start ((Get-Date).AddDays(-30)).ToString() -RecurCount 7 -RecurInterval Minutes

$dep = New-CMSettingDeployment -CMSetting $setting -Collection $collection -Schedule $sched

Parameter

-CMSetting

Geben Sie ein bereitzustellende Einstellungsobjekt an.

Typ:CMSettings
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Collection

Geben Sie ein Auflistungsobjekt als Ziel für die Bereitstellung an. Verwenden Sie zum Abrufen einer Sammlung das Cmdlet Get-CMCollection .

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

-CollectionId

Geben Sie die ID der Sammlung als Ziel für die Bereitstellung an.

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

-CollectionName

Geben Sie den Namen der Sammlung als Ziel für die Bereitstellung an.

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

-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

-OverrideServiceWindows

Wenn Sie diesen Parameter hinzufügen, kann der Client die Einstellungen außerhalb eines Wartungsfensters korrigieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Schedule

Geben Sie ein Zeitplanobjekt an, das auf die Bereitstellung angewendet werden soll. Verwenden Sie zum Erstellen eines benutzerdefinierten Zeitplans das Cmdlet New-CMSchedule .

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

Eingaben

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.EP.SimplifiedSettings.CMSettings

Ausgaben

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment