Set-CMConfigurationPolicyDeployment

Set-CMConfigurationPolicyDeployment

Creates a configuration policy deployment.

Syntax

Parameter Set: SetFWPolicyDeploymentByIdMandatory
Set-CMConfigurationPolicyDeployment -CollectionName <String> -FirewallPolicyId <String> [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetFWPolicyDeploymentByNameMandatory
Set-CMConfigurationPolicyDeployment -CollectionName <String> -FirewallPolicyName <String> [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetFWPolicyDeploymentByValueMandatory
Set-CMConfigurationPolicyDeployment -CollectionName <String> -FirewallPolicy <IResultObject> [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetUSMPolicyDeploymentByIdMandatory
Set-CMConfigurationPolicyDeployment -CollectionName <String> -UserDataAndProfileId <String> [-EnableEnforcement <Boolean> ] [-GenerateAlert <Boolean> ] [-MonitoredByScom <Boolean> ] [-OverrideServiceWindow <Boolean> ] [-ParameterValue <Int32> ] [-PostponeDate <DateTime> ] [-PostponeTime <DateTime> ] [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetUSMPolicyDeploymentByNameMandatory
Set-CMConfigurationPolicyDeployment -CollectionName <String> -UserDataAndProfileName <String> [-EnableEnforcement <Boolean> ] [-GenerateAlert <Boolean> ] [-MonitoredByScom <Boolean> ] [-OverrideServiceWindow <Boolean> ] [-ParameterValue <Int32> ] [-PostponeDate <DateTime> ] [-PostponeTime <DateTime> ] [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetUSMPolicyDeploymentByValueMandatory
Set-CMConfigurationPolicyDeployment -CollectionName <String> -UserDataAndProfile <IResultObject> [-EnableEnforcement <Boolean> ] [-GenerateAlert <Boolean> ] [-MonitoredByScom <Boolean> ] [-OverrideServiceWindow <Boolean> ] [-ParameterValue <Int32> ] [-PostponeDate <DateTime> ] [-PostponeTime <DateTime> ] [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Set-CMConfigurationPolicyDeployment cmdlet creates a configuration policy deployment in Microsoft System Center 2012 SP1 Configuration Manager. You can deploy firewall policies or user session management policies. Use the Start-CMConfigurationPolicyDeployment cmdlet to deploy specified policies for a System Center 2012 Configuration Manager collection.

Parameters

-CollectionName<String>

Specifies the name of a collection. The deployment applies to this collection.

-EnableEnforcement<Boolean>

Indicates whether to enable enforcement for the deployment. During enforcement, a client reports compliance information about a deployment.

-FirewallPolicy<IResultObject>

Specifies a Windows Firewall Policy object. To obtain a CMWindowsFirewallPolicy object, use the Get-CMWindowsFirewallPolicy cmdlet.

-FirewallPolicyId<String>

Specifies the ID of a Windows Firewall policy.

-FirewallPolicyName<String>

Specifies the name of a Windows Firewall policy.

-GenerateAlert<Boolean>

Indicates whether Configuration Manager generates alerts during the deployment.

-MonitoredByScom<Boolean>

Indicates whether System Center 2012 – Operations Manager monitoring criteria applies during the deployment.

-OverrideServiceWindow<Boolean>

Indicates whether to override the service window while deploying policies. Service windows are periods of time allocated for maintenance.

-ParameterValue<Int32>

Specifies the values of administrator-defined parameters, such as thresholds. Configuration Manager stores the values in XML format.

-PostponeDate<DateTime>

Specifies a date, as a DateTime object, for the deployment if it is postponed. To obtain a DateTime object, use the Get-Date cmdlet. For more information, type Get-Help Get-Date.

-PostponeTime<DateTime>

Specifies a time, as a DateTime object, for the deployment if it is postponed. To obtain a DateTime object, use the Get-Date cmdlet.

-Schedule<IResultObject>

Specifies a schedule object. This is the schedule for deploying the configuration policy. You can use the New-CMSchedule cmdlet to create a schedule token.

-UserDataAndProfile<IResultObject>

Specifies a user data and profiles configuration item object. To obtain a CMUserDataAndProfileConfigurationItem object, use the Get-CMUserDataAndProfileConfigurationItem cmdlet.

-UserDataAndProfileId<String>

Specifies an ID of a user data and profile configuration item.

-UserDataAndProfileName<String>

Specifies a name of a user data and profile configuration item.

-Confirm

Prompts you for confirmation before running the cmdlet.

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Create a configuration policy deployment

This command creates a configuration policy deployment named Remote Firewall Policy and deploys it to the collection named Regional Remote Users.

PS C:\> Set-CMConfigurationPolicyDeployment -CollectionName "Regional Remote Users" -FirewallPolicyName "Remote Firewall Policy"

Related topics

Get-CMUserDataAndProfileConfigurationItem

Get-CMWindowsFirewallPolicy

New-CMSchedule

Start-CMConfigurationPolicyDeployment