Condividi tramite

New-CMSettingDeployment

  • Riferimento
Modulo:
ConfigurationManager

Distribuire un oggetto criteri di impostazioni in una raccolta.

Sintassi

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

Descrizione

Distribuire un oggetto criteri di impostazioni in una raccolta. Ad esempio, distribuire un criterio di gestione di BitLocker o un criterio di Controllo applicazioni di Microsoft Defender. Per creare una pianificazione personalizzata, usare il cmdlet New-CMSchedule . Per ottenere una raccolta, usare il cmdlet Get-CMCollection .

Esempio

Esempio 1: Distribuire un oggetto di gestione BitLocker in tutti i client desktop e server

Questo esempio ottiene un oggetto impostazioni di gestione BitLocker per nome e archivia l'oggetto nella variabile $setting . Ottiene quindi una raccolta in base al nome e archivia l'oggetto nella variabile $collection . Usa il cmdlet New-CMSettingDeployment per distribuire l'oggetto impostazioni di gestione BitLocker in tale raccolta.

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

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

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

Esempio 2: Distribuire un'impostazione di Windows Defender Application Control usando una pianificazione personalizzata

Questo esempio crea anche una pianificazione personalizzata usando il cmdlet New-CMSchedule .

$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

Parametri

-CMSetting

Specificare un oggetto impostazioni da distribuire.

Tipo:CMSettings
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Collection

Specificare un oggetto raccolta come destinazione per la distribuzione. Per ottenere una raccolta, usare il cmdlet Get-CMCollection .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionId

Specificare l'ID della raccolta come destinazione per la distribuzione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionName

Specificare il nome della raccolta come destinazione per la distribuzione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OverrideServiceWindows

Quando si aggiunge questo parametro, il client può correggere le impostazioni all'esterno di una finestra di manutenzione.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Schedule

Specificare un oggetto pianificazione da applicare alla distribuzione. Per creare una pianificazione personalizzata, usare il cmdlet New-CMSchedule .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

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

Output

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