Start-CMConfigurationPolicyDeployment

Deploys policies for a Configuration Manager collection.

Syntax

Start-CMConfigurationPolicyDeployment
     -CollectionName <String>
     [-Confirm]
     [-DisableWildcardHandling]
     [-EnableEnforcement <Boolean>]
     [-ForceWildcardHandling]
     [-GenerateAlert <Boolean>]
     [-MonitoredByScom <Boolean>]
     [-OverrideServiceWindow <Boolean>]
     [-ParameterValue <Int32>]
     [-PassThru]
     [-PostponeDate <DateTime>]
     [-PostponeTime <DateTime>]
     [-Schedule <IResultObject>]
     -UserDataAndProfileName <String>
     [-WhatIf]
     [<CommonParameters>]
Start-CMConfigurationPolicyDeployment -CollectionName  [-Confirm] [-DisableWildcardHandling]
 [-EnableEnforcement ] [-ForceWildcardHandling] [-GenerateAlert ]
 [-MonitoredByScom ] [-OverrideServiceWindow ] [-ParameterValue ] [-PassThru]
 [-PostponeDate ] [-PostponeTime ] [-Schedule ]
 -UserDataAndProfileId  [-WhatIf] []
Start-CMConfigurationPolicyDeployment -CollectionName  [-Confirm] [-DisableWildcardHandling]
 [-EnableEnforcement ] [-ForceWildcardHandling] [-GenerateAlert ]
 [-MonitoredByScom ] [-OverrideServiceWindow ] [-ParameterValue ] [-PassThru]
 [-PostponeDate ] [-PostponeTime ] [-Schedule ]
 -UserDataAndProfile  [-WhatIf] []
Start-CMConfigurationPolicyDeployment -CollectionName  [-Confirm] [-DisableWildcardHandling]
 [-EnableEnforcement ] [-ForceWildcardHandling] [-GenerateAlert ]
 [-MonitoredByScom ] [-OverrideServiceWindow ] [-ParameterValue ] [-PassThru]
 [-PostponeDate ] [-PostponeTime ] -RemoteConnectionProfileName 
 [-Schedule ] [-WhatIf] []
Start-CMConfigurationPolicyDeployment -CollectionName  [-Confirm] [-DisableWildcardHandling]
 [-EnableEnforcement ] [-ForceWildcardHandling] [-GenerateAlert ]
 [-MonitoredByScom ] [-OverrideServiceWindow ] [-ParameterValue ] [-PassThru]
 [-PostponeDate ] [-PostponeTime ] -RemoteConnectionProfileId 
 [-Schedule ] [-WhatIf] []
Start-CMConfigurationPolicyDeployment -CollectionName  [-Confirm] [-DisableWildcardHandling]
 [-EnableEnforcement ] [-ForceWildcardHandling] [-GenerateAlert ]
 [-MonitoredByScom ] [-OverrideServiceWindow ] [-ParameterValue ] [-PassThru]
 [-PostponeDate ] [-PostponeTime ] -RemoteConnectionProfile 
 [-Schedule ] [-WhatIf] []
Start-CMConfigurationPolicyDeployment -CollectionName  [-Confirm] [-DisableWildcardHandling]
 -FirewallPolicy  [-ForceWildcardHandling] [-PassThru] [-Schedule ] [-WhatIf]
 []
Start-CMConfigurationPolicyDeployment -CollectionName  [-Confirm] [-DisableWildcardHandling]
 -FirewallPolicyId  [-ForceWildcardHandling] [-PassThru] [-Schedule ] [-WhatIf]
 []
Start-CMConfigurationPolicyDeployment -CollectionName  [-Confirm] [-DisableWildcardHandling]
 -FirewallPolicyName  [-ForceWildcardHandling] [-PassThru] [-Schedule ] [-WhatIf]
 []

Description

The Start-CMConfigurationPolicyDeployment cmdlet deploys specified policies for a Microsoft System Center 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 2016 - Operations Manager monitoring criteria.

Examples

Example 1: Start deployment of a firewall policy

PS C:\> Start-CMConfigurationPolicyDeployment -CollectionName "Desktop systems" -FirewallPolicyName "General 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.

Required Parameters

-CollectionName

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

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FirewallPolicy

Specifies a firewall policy object.

Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-FirewallPolicyId

Specifies an ID for a firewall policy.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FirewallPolicyName

Specifies a name for a firewall policy.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoteConnectionProfile

Specifies the remote connection profile that this cmdlet deploys configuration policy on.

Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-RemoteConnectionProfileId

Specifies the remote connection profile ID that this cmdlet deploys configuration policy for.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoteConnectionProfileName

Specifies the remote connection profile name that this cmdlet deploys configuration policy for.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserDataAndProfile

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

Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-UserDataAndProfileId

Specifies an ID for a user data and profile object.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserDataAndProfileName

Specifies a name for a user data and profile object.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableEnforcement

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

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-GenerateAlert

Specifies whether Configuration Manager generates alerts during the deployment.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MonitoredByScom

Specifies whether Operations Manager monitoring criteria applies during the deployment.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OverrideServiceWindow

Specifies whether to override the service window while deploying policies.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ParameterValue

Specifies an integer value. This is the parameter value.

Type:Int32
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PostponeDate

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.

Type:DateTime
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PostponeTime

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.

Type:DateTime
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Schedule

Specifies a schedule object. This is the schedule for evaluating the policy.

Type:IResultObject
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

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

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False