Set-CMConfigurationPolicyDeployment

Creates a configuration policy deployment.

Syntax

Set-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>]
Set-CMConfigurationPolicyDeployment -CollectionName  [-Confirm] [-DisableWildcardHandling]
 [-EnableEnforcement ] [-ForceWildcardHandling] [-GenerateAlert ]
 [-MonitoredByScom ] [-OverrideServiceWindow ] [-ParameterValue ] [-PassThru]
 [-PostponeDate ] [-PostponeTime ] [-Schedule ]
 -UserDataAndProfileId  [-WhatIf] []
Set-CMConfigurationPolicyDeployment -CollectionName  [-Confirm] [-DisableWildcardHandling]
 [-EnableEnforcement ] [-ForceWildcardHandling] [-GenerateAlert ]
 [-MonitoredByScom ] [-OverrideServiceWindow ] [-ParameterValue ] [-PassThru]
 [-PostponeDate ] [-PostponeTime ] [-Schedule ]
 -UserDataAndProfile  [-WhatIf] []
Set-CMConfigurationPolicyDeployment -CollectionName  [-Confirm] [-DisableWildcardHandling]
 -FirewallPolicy  [-ForceWildcardHandling] [-PassThru] [-Schedule ] [-WhatIf]
 []
Set-CMConfigurationPolicyDeployment -CollectionName  [-Confirm] [-DisableWildcardHandling]
 -FirewallPolicyId  [-ForceWildcardHandling] [-PassThru] [-Schedule ] [-WhatIf]
 []
Set-CMConfigurationPolicyDeployment -CollectionName  [-Confirm] [-DisableWildcardHandling]
 -FirewallPolicyName  [-ForceWildcardHandling] [-PassThru] [-Schedule ] [-WhatIf]
 []

Description

The Set-CMConfigurationPolicyDeployment cmdlet creates a configuration policy deployment in Microsoft System Center 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 Configuration Manager collection.

Examples

Example 1: Create a configuration policy deployment

PS C:\> Set-CMConfigurationPolicyDeployment -CollectionName "Regional Remote Users" -FirewallPolicyName "Remote Firewall Policy"

This command creates a configuration policy deployment named Remote Firewall Policy and deploys it to the collection named Regional Remote Users.

Required Parameters

-CollectionName

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

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

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

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

Specifies the ID of a Windows Firewall policy.

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

Specifies the name of a Windows Firewall policy.

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

Specifies a user data and profiles configuration item object. To obtain a CMUserDataAndProfileConfigurationItem 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 of a user data and profile configuration item.

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

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

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

Indicates 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

Indicates whether System Center 2016 - 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

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

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

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

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, for the deployment if it is postponed. To obtain a DateTime object, use the Get-Date cmdlet. For more information, type Get-Help Get-Date.

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, for the deployment if it is postponed. To obtain a DateTime object, use the Get-Date cmdlet.

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 deploying the configuration policy. You can use the New-CMSchedule cmdlet to create a schedule token.

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