Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

New-CMTSStepSetDynamicVariable

Create a Set Dynamic Variables step, which you can add to a task sequence.

Syntax

Default (Default)

New-CMTSStepSetDynamicVariable
 -AddRule <IResultObject[]>
 [-Condition <IResultObject[]>]
 [-ContinueOnError]
 [-Description <String>]
 [-Disable]
 -Name <String>
 [-DisableWildcardHandling]
 [-ForceWildcardHandling]
 [-WhatIf]
 [-Confirm]
 [<CommonParameters>]

Description

This cmdlet creates a new Set Dynamic Variables step object. Use the New-CMTSRule cmdlet to define the rules for this step. Then use the Add-CMTaskSequenceStep cmdlet to add the step to a task sequence. For more information on this step, see About task sequence steps: Set Dynamic Variables.

Note

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

Examples

Example 1

This example first uses the New-CMTSRule cmdlet to create two rules.

It then creates an object for the Set Dynamic Variables step, and adds this rule.

Finally, it gets a task sequence object, and adds this new step to the task sequence at index 11.

$tsrule1 = New-CMTSRule -Variable @{'OSDDownloadDestinationLocationType' = 'TSCache'} -ReferencedVariableName "_SMSTSInWinPE" -ReferencedVariableOperator Equals -ReferencedVariableValue TRUE

$tsrule2 = New-CMTSRule -Variable @{'OSDMigrateUseHardlinks' = 'true'} -ReferencedVariableName "_SMSTSMediaType" -ReferencedVariableOperator NotEquals -ReferencedVariableValue "OEMMedia"

$step = New-CMTSStepSetDynamicVariable -Name "Set Dynamic Variables" -AddRule $tsrule1,$tsrule2

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

Parameters

-AddRule

Specify one or more rule objects. Rules define the criteria and variables to set when they evaluate true. To get this object, use the New-CMTSRule cmdlet. The order of the rules in the array determines the order in this step.

Parameter properties

Type:

IResultObject[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:AddRules

Parameter sets

-Condition

Specify a condition object to use with this step. To get this object, use one of the task sequence condition cmdlets. For example, Get-CMTSStepConditionVariable.

Parameter properties

Type:

IResultObject[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:Conditions

Parameter sets

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

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

Parameter sets

-ContinueOnError

Add this parameter to enable the step option Continue on error. When you enable this option, if the step fails, the task sequence continues.

Parameter properties

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

Parameter sets

-Description

Specify an optional description for this task sequence step.

Parameter properties

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

Parameter sets

-Disable

Add this parameter to disable this task sequence step.

Parameter properties

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

Parameter sets

-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

-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

-Name

Specify a name for this step to identify it in the task sequence.

Parameter properties

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

Parameter sets

-WhatIf

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

Parameter properties

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

Parameter sets

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

None

Outputs

IResultObject

Related Links


Feedback

Was this page helpful?