New-CMSettingDeployment
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