Start-CMConfigurationPolicyDeployment

Deploys policies for a Configuration Manager collection.

Syntax

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

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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FirewallPolicy

Specifies a firewall policy object.

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

Specifies an ID for a firewall policy.

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

Specifies a name for a firewall policy.

Type:String
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
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
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
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
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
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
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
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type:SwitchParameter
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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
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
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
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
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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

Returns the current working object. By default, this cmdlet does not generate any output.

Type:SwitchParameter
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
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
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
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
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False