Start-CMConfigurationPolicyDeployment
Start-CMConfigurationPolicyDeployment
Deploys policies for a Configuration Manager collection.
Syntax
Parameter Set: DeployFWPolicyByIdMandatory
Start-CMConfigurationPolicyDeployment -CollectionName <String> -FirewallPolicyId <String> [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: DeployFWPolicyByNameMandatory
Start-CMConfigurationPolicyDeployment -CollectionName <String> -FirewallPolicyName <String> [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: DeployFWPolicyByValueMandatory
Start-CMConfigurationPolicyDeployment -CollectionName <String> -FirewallPolicy <IResultObject> [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: DeployRCPolicyByIdMandatory
Start-CMConfigurationPolicyDeployment -CollectionName <String> -RemoteConnectionProfileId <String> [-EnableEnforcement <Boolean> ] [-GenerateAlert <Boolean> ] [-MonitoredByScom <Boolean> ] [-OverrideServiceWindow <Boolean> ] [-ParameterValue <Int32> ] [-PostponeDate <DateTime> ] [-PostponeTime <DateTime> ] [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: DeployRCPolicyByNameMandatory
Start-CMConfigurationPolicyDeployment -CollectionName <String> -RemoteConnectionProfileName <String> [-EnableEnforcement <Boolean> ] [-GenerateAlert <Boolean> ] [-MonitoredByScom <Boolean> ] [-OverrideServiceWindow <Boolean> ] [-ParameterValue <Int32> ] [-PostponeDate <DateTime> ] [-PostponeTime <DateTime> ] [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: DeployRCPolicyByValueMandatory
Start-CMConfigurationPolicyDeployment -CollectionName <String> -RemoteConnectionProfile <IResultObject> [-EnableEnforcement <Boolean> ] [-GenerateAlert <Boolean> ] [-MonitoredByScom <Boolean> ] [-OverrideServiceWindow <Boolean> ] [-ParameterValue <Int32> ] [-PostponeDate <DateTime> ] [-PostponeTime <DateTime> ] [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: DeployUSMPolicyByIdMandatory
Start-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: DeployUSMPolicyByNameMandatory
Start-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: DeployUSMPolicyByValueMandatory
Start-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 Start-CMConfigurationPolicyDeployment cmdlet deploys specified policies for a Microsoft System Center 2012 SP1 Configuration Manager collection. You can deploy firewall policies or user session management policies.
You can specify a firewall policy by name or by ID or use another cmdlet to get firewall policy object.
You can specify System Center 2012 – Operations Manager monitoring criteria.
Parameters
-CollectionName<String>
Specifies the name of a collection. The deployment applies to this Configuration Manager collection.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-EnableEnforcement<Boolean>
Indicates whether to enable enforcement for the deployment. During enforcement, a client reports compliance information about a deployment.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FirewallPolicy<IResultObject>
Specifies a firewall policy object.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FirewallPolicyId<String>
Specifies an ID for a firewall policy.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FirewallPolicyName<String>
Specifies a name for a firewall policy.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-GenerateAlert<Boolean>
Specifies 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 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>
Specifies whether to override the service window while deploying policies.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ParameterValue<Int32>
Specifies an integer value. This is the parameter value.
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. To get a DateTime object, use the Get-Date cmdlet. For more information, type Get-Help Get-Date
. This is the date for the deployment if 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. To obtain a DateTime object, use the Get-Date cmdlet. This is the time for the deployment if postponed.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-RemoteConnectionProfile<IResultObject>
Specifies the remote connection profile that this cmdlet deploys configuration policy on.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-RemoteConnectionProfileId<String>
Specifies the remote connection profile ID that this cmdlet deploys configuration policy for.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-RemoteConnectionProfileName<String>
Specifies the remote connection profile name that this cmdlet deploys configuration policy for.
Aliases |
none |
Required? |
true |
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 evaluating the policy.
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 profile object. To obtain a user data and profile 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 for a user data and profile object.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-UserDataAndProfileName<String>
Specifies a name for a user data and profile object.
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: Start deployment of a firewall policy
This command starts the configuration policy deployment for a collection named Desktop systems. The command specifies a firewall policy named General firewall policy.
PS C:\> Start-CMConfigurationPolicyDeployment -CollectionName "Desktop systems" -FirewallPolicyName "General firewall policy"