Set-CMConfigurationPolicyDeployment

Module:

ConfigurationManager

Creates a configuration policy deployment.

Syntax

Set-CMConfigurationPolicyDeployment
   [-EnableEnforcement <Boolean>]
   [-GenerateAlert <Boolean>]
   -InputObject <IResultObject>
   [-MonitoredByScom <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-ParameterValue <Int32>]
   [-PostponeDateTime <DateTime>]
   [-Schedule <IResultObject>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMConfigurationPolicyDeployment
   [-EnableEnforcement <Boolean>]
   -FirewallPolicyId <String>
   [-GenerateAlert <Boolean>]
   [-MonitoredByScom <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-ParameterValue <Int32>]
   [-PostponeDateTime <DateTime>]
   [-Schedule <IResultObject>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMConfigurationPolicyDeployment
   [-EnableEnforcement <Boolean>]
   -FirewallPolicyName <String>
   [-GenerateAlert <Boolean>]
   [-MonitoredByScom <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-ParameterValue <Int32>]
   [-PostponeDateTime <DateTime>]
   [-Schedule <IResultObject>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMConfigurationPolicyDeployment
   [-EnableEnforcement <Boolean>]
   [-GenerateAlert <Boolean>]
   [-MonitoredByScom <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-ParameterValue <Int32>]
   [-PostponeDateTime <DateTime>]
   -RemoteConnectionProfileId <String>
   [-Schedule <IResultObject>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMConfigurationPolicyDeployment
   [-EnableEnforcement <Boolean>]
   [-GenerateAlert <Boolean>]
   [-MonitoredByScom <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-ParameterValue <Int32>]
   [-PostponeDateTime <DateTime>]
   -RemoteConnectionProfileName <String>
   [-Schedule <IResultObject>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMConfigurationPolicyDeployment
   [-EnableEnforcement <Boolean>]
   [-GenerateAlert <Boolean>]
   [-MonitoredByScom <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-ParameterValue <Int32>]
   [-PostponeDateTime <DateTime>]
   [-Schedule <IResultObject>]
   -UserDataAndProfileId <String>
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMConfigurationPolicyDeployment
   [-EnableEnforcement <Boolean>]
   [-GenerateAlert <Boolean>]
   [-MonitoredByScom <Boolean>]
   [-OverrideServiceWindow <Boolean>]
   [-ParameterValue <Int32>]
   [-PostponeDateTime <DateTime>]
   [-Schedule <IResultObject>]
   -UserDataAndProfileName <String>
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-CMConfigurationPolicyDeployment cmdlet creates a configuration policy deployment in Configuration Manager. You can deploy firewall policies or user session management policies. Use the New-CMConfigurationPolicyDeployment cmdlet to deploy specified policies for a Configuration Manager collection.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Create a configuration policy deployment

PS XYZ:\> 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.

Parameters

-Collection

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

-CollectionId

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

-CollectionName

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

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

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-FirewallPolicyId

Specifies the ID of a Windows Firewall policy.

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

-FirewallPolicyName

Specifies the name of a Windows Firewall policy.

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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

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

-GenerateAlert

Indicates whether Configuration Manager generates alerts during the deployment.

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

-InputObject

Type:	IResultObject
Aliases:	UserDataAndProfile, FirewallPolicy, RemoteConnectionProfile, DeploymentSummary, Assignment
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MonitoredByScom

Indicates whether System Center 2016 - Operations Manager monitoring criteria applies during the deployment.

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

-PassThru

Add this parameter to return an object that represents the item with which you're working. By default, this cmdlet may not generate any output.

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

-PostponeDateTime

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

-RemoteConnectionProfileId

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

-RemoteConnectionProfileName

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

-UserDataAndProfileId

Specifies an ID of a user data and profile configuration item.

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

-UserDataAndProfileName

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

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

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

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

System.Object

Related Links

• Get-CMUserDataAndProfileConfigurationItem
• Get-CMWindowsFirewallPolicy
• New-CMSchedule
• New-CMConfigurationPolicyDeployment