Start-CMAntimalwarePolicyDeployment
Start-CMAntimalwarePolicyDeployment
Starts the deployment of an antimalware policy to the members of a Configuration Manager collection.
構文
Parameter Set: SearchByAntimalwarePolicyId_CollectionId
Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyId <String> -CollectionId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByAntimalwarePolicyId_CollectionName
Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyId <String> -CollectionName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByAntimalwarePolicyId_CollectionValue
Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyId <String> -Collection <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByAntimalwarePolicyName_CollectionId
Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyName <String> -CollectionId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByAntimalwarePolicyName_CollectionName
Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyName <String> -CollectionName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByAntimalwarePolicyName_CollectionValue
Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyName <String> -Collection <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByAntimalwarePolicyValue_CollectionId
Start-CMAntimalwarePolicyDeployment -AntimalwarePolicy <IResultObject> -CollectionId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByAntimalwarePolicyValue_CollectionName
Start-CMAntimalwarePolicyDeployment -AntimalwarePolicy <IResultObject> -CollectionName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByAntimalwarePolicyValue_CollectionValue
Start-CMAntimalwarePolicyDeployment -AntimalwarePolicy <IResultObject> -Collection <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: StartDeploymentByName
Start-CMAntimalwarePolicyDeployment -Name <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The Start-CMAntimalwarePolicyDeployment cmdlet starts the deployment of a Microsoft System Center 2012 Endpoint Protection antimalware policy to the members of a Microsoft System Center 2012 Configuration Manager collection.
To start a policy deployment, specify the antimalware policy to be deployed and the device collection that is the destination for the deployment. Specify a policy by name or by ID, or use the Get-CMAntimalwarePolicy cmdlet to get a policy object. Specify a collection by name or by ID, or use the Get-CMDeviceCollection cmdlet to get a collection object. You can also specify a deployment name to deploy a policy.
パラメーター
-AntimalwarePolicy<IResultObject>
Specifies an antimalware policy object in Configuration Manager. To obtain an antimalware policy object, use the Get-CMAntiMalwarePolicy cmdlet.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-AntimalwarePolicyId<String>
Specifies the ID of an antimalware policy.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-AntimalwarePolicyName<String>
Specifies the name of an antimalware policy.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Collection<IResultObject>
Specifies a Configuration Manager device collection object. To obtain a device collection object, use the Get-CMDeviceCollection cmdlet.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-CollectionId<String>
Specifies the ID of a device collection.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-CollectionName<String>
Specifies the name of a device collection.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Name<String>
Specifies the name of an antimalware policy deployment.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Confirm
コマンドレットを実行する前に、ユーザーに確認を求めます。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WhatIf
コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
例
Example 1: Deploy an antimalware policy to a collection by using an ID
This command starts the deployment for a policy named ExclusionsPolicy to a device collection that has the ID SMS00023.
PS C:\> Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyName "ExclusionsPolicy" -CollectionId "SMS00023"
Example 2: Deploy an antimalware policy to a named collection
This command starts the deployment for a policy named ExclusionsPolicy to a device collection named SouthOffice.
PS C:\> Start-CMAntimalwarePolicyDeployment -AntimalwarePolicyName "ExclusionsPolicy" -CollectionName "SouthOffice"