Set-CMConfigurationPolicyDeployment

Creates a configuration policy deployment.

Syntax

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

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

-FirewallPolicyId

Specifies the ID of a Windows Firewall policy.

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

Specifies the name of a Windows Firewall policy.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject
Type:IResultObject
Aliases:UserDataAndProfile, FirewallPolicy, RemoteConnectionProfile, DeploymentSummary, Assignment
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-RemoteConnectionProfileId
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoteConnectionProfileName
Type:String
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

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

Indicates whether Configuration Manager generates alerts during the deployment.

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

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