Dela via


New-CMSettingDeployment

SYNOPSIS

Distribuera ett inställningsprincipobjekt till en samling.

SYNTAX

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

DESCRIPTION

Distribuera ett inställningsprincipobjekt till en samling. Du kan till exempel distribuera en BitLocker-hanteringsprincip eller en Microsoft Defender Application Control princip. Om du vill skapa ett anpassat schema använder du cmdleten New-CMSchedule. Om du vill hämta en samling använder du cmdleten Get-CMCollection.

EXAMPLES

Exempel 1: Distribuera ett BitLocker-hanteringsobjekt till alla skrivbords- och serverklienter

Det här exemplet hämtar ett BitLocker-hanteringsinställningsobjekt efter namn och lagrar objektet i $setting variabeln. Den hämtar sedan en samling efter namn och lagrar objektet i $collection variabeln. Den använder cmdleten New-CMSettingDeployment för att distribuera bitLocker-hanteringsinställningsobjektet till samlingen.

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

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

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

Exempel 2: Distribuera en Windows Defender för programkontroll med hjälp av ett anpassat schema

Det här exemplet skapar också ett anpassat schema med cmdleten 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

PARAMETERS

-CMSetting

Ange ett inställningsobjekt som ska distribueras.

Type: CMSettings
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Samling

Ange ett samlingsobjekt som mål för distributionen. Om du vill hämta en samling använder du cmdleten Get-CMCollection.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-CollectionId

Ange ID för samlingen som mål för distributionen.

Type: String
Parameter Sets: (All)
Aliases:

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

-CollectionName

Ange namnet på samlingen som mål för distributionen.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-OverrideServiceWindows

När du lägger till den här parametern kan klienten reparera inställningarna utanför en underhållsfönstret.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Schema

Ange ett schemaobjekt som ska tillämpas på distributionen. Om du vill skapa ett anpassat schema använder du cmdleten New-CMSchedule.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

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

OUTPUTS

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

ANTECKNINGAR

Get-CMBlmSetting

New-CMBlmSetting

Get-CMWdacSetting

New-CMWdacSetting

Get-CMCollection

New-CMSchedule

Get-CMSettingDeployment

Remove-CMSettingDeployment

Set-CMSettingDeployment