Edit

Share via

Set-CMConfigurationPolicyDeployment

Module:
ConfigurationManager Module

Creates a configuration policy deployment.

Syntax

SetPoicyByValueMandatory (Default) 

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

SetFWPolicyDeploymentByIdMandatory 

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

SetFWPolicyDeploymentByNameMandatory 

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

SetRemoteConnectionDeploymentByIdMandatory 

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

SetRemoteConnectionDeploymentByNameMandatory 

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

SetUSMPolicyDeploymentByIdMandatory 

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

SetUSMPolicyDeploymentByNameMandatory 

Set-CMConfigurationPolicyDeployment
    -UserDataAndProfileName <String>
    [-EnableEnforcement <Boolean>]
    [-GenerateAlert <Boolean>]
    [-MonitoredByScom <Boolean>]
    [-OverrideServiceWindow <Boolean>]
    [-ParameterValue <Int32>]
    [-PostponeDateTime <DateTime>]
    [-Schedule <IResultObject>]
    [-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

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.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CollectionId

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CollectionName

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

Parameter properties

Type:String
Default value:None
Supports wildcards:True
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableWildcardHandling

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableEnforcement

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-FirewallPolicyId

Specifies the ID of a Windows Firewall policy.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SetFWPolicyDeploymentByIdMandatory
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-FirewallPolicyName

Specifies the name of a Windows Firewall policy.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SetFWPolicyDeploymentByNameMandatory
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ForceWildcardHandling

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-GenerateAlert

Indicates whether Configuration Manager generates alerts during the deployment.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

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.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False
Aliases:UserDataAndProfile, FirewallPolicy, RemoteConnectionProfile, DeploymentSummary, Assignment

Parameter sets

SetPoicyByValueMandatory
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-MonitoredByScom

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-OverrideServiceWindow

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ParameterValue

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PostponeDateTime

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.

Parameter properties

Type:DateTime
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RemoteConnectionProfileId

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SetRemoteConnectionDeploymentByIdMandatory
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RemoteConnectionProfileName

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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SetRemoteConnectionDeploymentByNameMandatory
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-UserDataAndProfileId

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SetUSMPolicyDeploymentByIdMandatory
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-UserDataAndProfileName

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SetUSMPolicyDeploymentByNameMandatory
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

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

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

System.Object