Export (0) Print
Expand All
Expand Minimize

Set-CMConfigurationPolicyDeployment

Updated: September 1, 2013

Applies To: System Center 2012 Configuration Manager SP1

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 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.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableEnforcement<Boolean>

Indicates whether policy enforcement is enabled.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-FirewallPolicy<IResultObject>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-FirewallPolicyId<String>

Specifies the ID of a Windows Firewall policy.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-FirewallPolicyName<String>

Specifies the name of a Windows Firewall policy.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-GenerateAlert<Boolean>

Indicates whether Configuration Manager generates alerts during the deployment.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MonitoredByScom<Boolean>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-OverrideServiceWindow<Boolean>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ParameterValue<Int32>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PostponeDate<DateTime>

Specifies a date, as a DateTime object, for the deployment if it is postponed.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PostponeTime<DateTime>

Specifies a time, as a DateTime object, for the deployment if it is postponed.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UserDataAndProfile<IResultObject>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UserDataAndProfileId<String>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UserDataAndProfileName<String>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

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

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft