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 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 running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
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 (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
Start-CMConfigurationPolicyDeployment