New-CMSettingDeployment

Riferimento

Modulo:: ConfigurationManager

Distribuire un oggetto criteri impostazioni in un insieme.

Sintassi

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

Descrizione

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

Esempio

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

Questo esempio consente di ottenere un oggetto impostazioni di gestione di BitLocker in base al nome e di archiviare tale oggetto nella $setting variabile. Ottiene quindi un insieme in base al nome e archivia l'oggetto nella $collection variabile. Viene utilizzato 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 Windows Defender application control usando una pianificazione personalizzata

In questo esempio viene inoltre creata una pianificazione personalizzata utilizzando 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.

Per la gestione di BitLocker, utilizzare i cmdlet Get-CMBlmSetting o New-CMBlmSetting.
Per Microsoft Defender Application Control, utilizzare i cmdlet Get-CMWdacSetting o New-CMWdacSetting.

Type:	CMSettings
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Collection

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

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

-CollectionId

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

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

-CollectionName

Specificare il nome della raccolta come destinazione per la distribuzione.

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

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-OverrideServiceWindows

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Schedule

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

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

Input

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

Output

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