Start-CMAntimalwarePolicyDeployment

  • リファレンス
モジュール:
ConfigurationManager

(非推奨)Configuration Manager コレクションのメンバーへのマルウェア対策ポリシーの展開を開始します。

構文

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

説明

Start-CMAntimalwarePolicyDeployment コマンドレットは、Configuration Manager コレクションのメンバーへの Microsoft System Center 2016 Endpoint Protection マルウェア対策ポリシーの展開を開始します。

ポリシーの展開を開始するには、展開するマルウェア対策ポリシーと、展開の宛先となるデバイス コレクションを指定します。 名前または ID でポリシーを指定するか、 Get-CMAntiMalwarePolicy コマンドレットを使用してポリシー オブジェクトを取得します。 名前または ID でコレクションを指定するか、 Get-CMDeviceCollection コマンドレットを使用してコレクション オブジェクトを取得します。 デプロイ名を指定してポリシーをデプロイすることもできます。

重要

バージョン 2107 以降、このコマンドレットは非推奨となり、今後のリリースで削除される可能性があります。 代わりに、 New-CMAntimalwarePolicyDeployment コマンドレットを 使用します。

例

例 1: ID を使用してマルウェア対策ポリシーをコレクションに展開する

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

このコマンドは、Id SMS00023を持つデバイス コレクションへの ExclusionsPolicy という名前のポリシーのデプロイを開始します。

例 2: 名前付きコレクションにマルウェア対策ポリシーを展開する

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

このコマンドは、ExclusionsPolicy という名前のポリシーの SouthOffice という名前のデバイス コレクションへのデプロイを開始します。

パラメーター

-AntimalwarePolicy

Configuration Manager でマルウェア対策ポリシー オブジェクトを指定します。 マルウェア対策ポリシー オブジェクトを取得するには、 Get-CMAntiMalwarePolicy コマンドレットを 使用します。

型:IResultObject
Aliases:Policy
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-AntimalwarePolicyId

マルウェア対策ポリシーの ID を指定します。

型:String
Aliases:PolicyId
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AntimalwarePolicyName

マルウェア対策ポリシーの名前を指定します。

型:String
Aliases:PolicyName
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Collection

Configuration Manager デバイス コレクション オブジェクトを指定します。 デバイス コレクション オブジェクトを取得するには、 Get-CMDeviceCollection を使用します。

型:IResultObject
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-CollectionId

デバイス コレクションの ID を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CollectionName

デバイス コレクションの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object