Dela via


Start-CMAntimalwarePolicyDeployment

SYNOPSIS

(Inaktuell) Startar distributionen av en princip för program mot skadlig programvara till medlemmarna i en Konfigurationshanteraren samling.

SYNTAX

SearchByAntimalwarePolicyValue_CollectionValue (standard)

Start-CMAntimalwarePolicyDeployment -AntimalwarePolicy <IResultObject> -Collection <IResultObject>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByAntimalwarePolicyValue_CollectionId

Start-CMAntimalwarePolicyDeployment -AntimalwarePolicy <IResultObject> -CollectionId <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByAntimalwarePolicyValue_CollectionName

Start-CMAntimalwarePolicyDeployment -AntimalwarePolicy <IResultObject> -CollectionName <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByAntimalwarePolicyId_CollectionId

Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyId <String> -CollectionId <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByAntimalwarePolicyId_CollectionName

Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyId <String> -CollectionName <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByAntimalwarePolicyId_CollectionValue

Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyId <String> -Collection <IResultObject>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByAntimalwarePolicyName_CollectionId

Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyName <String> -CollectionId <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByAntimalwarePolicyName_CollectionName

Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyName <String> -CollectionName <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByAntimalwarePolicyName_CollectionValue

Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyName <String> -Collection <IResultObject>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Cmdleten Start-CMAntimalwarePolicyDeployment startar distributionen av en Microsoft System Center 2016 Endpoint Protection-princip för program mot skadlig programvara till medlemmarna i en Konfigurationshanteraren-samling.

Om du vill starta en principdistribution anger du den princip för program mot skadlig programvara som ska distribueras och den enhetssamling som är målet för distributionen. Ange en princip efter namn eller ID, eller använd cmdleten Get-CMAntiMalwarePolicy för att hämta ett principobjekt. Ange en samling efter namn eller ID, eller använd cmdleten Get-CMDeviceCollection för att hämta ett samlingsobjekt. Du kan också ange ett distributionsnamn för att distribuera en princip.

Viktigt

Från och med version 2107 är denna cmdlet inaktuell och kan tas bort i en framtida version. Använd i stället cmdleten New-CMAntimalwarePolicyDeployment.

EXAMPLES

Exempel 1: Distribuera en princip för program mot skadlig kod till en samling med hjälp av ett ID

PS XYZ:\> Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyName "ExclusionsPolicy" -CollectionId "SMS00023"

Det här kommandot startar distributionen för en princip med namnet ExclusionsPolicy till en enhetssamling som har ID:t SMS00023.

Exempel 2: Distribuera en princip för program mot skadlig programvara till en namngiven samling

PS XYZ:\> Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyName "ExclusionsPolicy" -CollectionName "SouthOffice"

Det här kommandot startar distributionen för en princip med namnet ExclusionsPolicy till en enhetssamling med namnet SouthOffice.

PARAMETERS

-AntimalwarePolicy

Anger ett principobjekt mot skadlig programvara i Konfigurationshanteraren. Om du vill hämta ett principobjekt mot skadlig programvara använder du cmdleten Get-CMAntiMalwarePolicy.

Type: IResultObject
Parameter Sets: SearchByAntimalwarePolicyValue_CollectionValue, SearchByAntimalwarePolicyValue_CollectionId, SearchByAntimalwarePolicyValue_CollectionName
Aliases: Policy

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

-AntimalwarePolicyId

Anger ID för en princip för program mot skadlig kod.

Type: String
Parameter Sets: SearchByAntimalwarePolicyId_CollectionId, SearchByAntimalwarePolicyId_CollectionName, SearchByAntimalwarePolicyId_CollectionValue
Aliases: PolicyId

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

-AntimalwarePolicyName

Anger namnet på en princip för program mot skadlig programvara.

Type: String
Parameter Sets: SearchByAntimalwarePolicyName_CollectionId, SearchByAntimalwarePolicyName_CollectionName, SearchByAntimalwarePolicyName_CollectionValue
Aliases: PolicyName

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

-Samling

Anger ett Konfigurationshanteraren enhetssamlingsobjekt. Om du vill hämta ett objekt för enhetssamling använder du Get-CMDeviceCollection.

Type: IResultObject
Parameter Sets: SearchByAntimalwarePolicyValue_CollectionValue, SearchByAntimalwarePolicyId_CollectionValue, SearchByAntimalwarePolicyName_CollectionValue
Aliases:

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

-CollectionId

Anger ID för en enhetssamling.

Type: String
Parameter Sets: SearchByAntimalwarePolicyValue_CollectionId, SearchByAntimalwarePolicyId_CollectionId, SearchByAntimalwarePolicyName_CollectionId
Aliases:

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

-CollectionName

Anger namnet på en enhetssamling.

Type: String
Parameter Sets: SearchByAntimalwarePolicyValue_CollectionName, SearchByAntimalwarePolicyId_CollectionName, SearchByAntimalwarePolicyName_CollectionName
Aliases:

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
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.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

Export-CMAntimalwarePolicy

Get-CMAntiMalwarePolicy

Merge-CMAntimalwarePolicy

New-CMAntimalwarePolicy

Remove-CMAntiMalwarePolicy

Set-CMAntiMalwarePolicy

Get-CMDeviceCollection