Start-CMBaselineDeployment

Start-CMBaselineDeployment

Starts deployment of a Configuration Manager baseline configuration to a collection of computers.

Syntax

Parameter Set: SearchByNameMandatory
Start-CMBaselineDeployment -CollectionName <String> -Name <String[]> [-EnableEnforcement <Boolean> ] [-GenerateAlert <Boolean> ] [-MonitoredByScom <Boolean> ] [-OverrideServiceWindow <Boolean> ] [-ParameterValue <Int32> ] [-PostponeDate <DateTime> ] [-PostponeTime <DateTime> ] [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory
Start-CMBaselineDeployment -CollectionName <String> -Id <String[]> [-EnableEnforcement <Boolean> ] [-GenerateAlert <Boolean> ] [-MonitoredByScom <Boolean> ] [-OverrideServiceWindow <Boolean> ] [-ParameterValue <Int32> ] [-PostponeDate <DateTime> ] [-PostponeTime <DateTime> ] [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Start-CMBaselineDeployment -CollectionName <String> -InputObject <IResultObject> [-EnableEnforcement <Boolean> ] [-GenerateAlert <Boolean> ] [-MonitoredByScom <Boolean> ] [-OverrideServiceWindow <Boolean> ] [-ParameterValue <Int32> ] [-PostponeDate <DateTime> ] [-PostponeTime <DateTime> ] [-Schedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Start-CMBaselineDeployment cmdlet starts the deployment of a Microsoft System Center 2012 Configuration Manager baseline configuration to a collection of computers.

A baseline defines the configuration of a product or system established at a specific time. Baselines contain a defined set of required configurations and associated rules. System Center 2012 Configuration Manager assigns baselines to computer in collections, together with a compliance evaluation schedule.

Parameters

-CollectionName<String>

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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableEnforcement<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-GenerateAlert<Boolean>

Specifies whether Configuration Manager generates alerts during the deployment.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Id<String[]>

Specifies an array of IDs of baseline deployments.

Aliases

CIId

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InputObject<IResultObject>

Specifies a baseline deployment object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MonitoredByScom<Boolean>

Specifies whether to apply Operations Manager monitoring criteria during the deployment.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String[]>

Specifies an array of names for baseline deployments.

Aliases

LocalizedDisplayName

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-OverrideServiceWindow<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ParameterValue<Int32>

Specifies an integer value. This is the parameter value.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PostponeDate<DateTime>

Specifies a date, as a DateTime object. This is the date for the deployment if postponed.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PostponeTime<DateTime>

Specifies a time, as a DateTime object. This is the time for the deployment if postponed.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Schedule<IResultObject>

Specifies a schedule object. This is the schedule for evaluating the baseline.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Start baseline deployment

This command starts a baseline deployment named Baseline22 for the collection All Users. The command enables enforcement, generates alerts, monitors the deployment using Operations Manager, and overrides defined service windows. The command specifies a parameter value of 30.

PS C:\> Start-CMBaselineDeployment -CollectionName "All Users" -Name "Baseline22" -EnableEnforcement $True -GenerateAlert $True -MonitoredByScom $True -OverrideServiceWindow $True -ParameterValue 30