New-CMTSStepPrestartCheck

Add the Check Readiness step to a task sequence. Use this step to verify that the target computer meets the specified deployment prerequisite conditions.

Syntax

New-CMTSStepPrestartCheck
   [-CheckSpace <Boolean>]
   [-DiskSpace <Int32>]
   [-CheckPowerState <Boolean>]
   [-CheckUefi <Boolean>]
   [-CheckNetworkConnected <Boolean>]
   [-CheckNetworkWired <Boolean>]
   [-CheckMemory <Boolean>]
   [-Memory <Int32>]
   [-CheckOSLanguageId <Boolean>]
   [-OSLanguageId <Int32>]
   [-CheckOS <Boolean>]
   [-OS <OSType>]
   [-CheckOSArchitecture <Boolean>]
   [-OSArchitecture <OSArch>]
   [-CheckMinOSVersion <Boolean>]
   [-MinOSVersion <String>]
   [-CheckMaxOSVersion <Boolean>]
   [-MaxOSVersion <String>]
   [-CheckCMClientMinVersion <Boolean>]
   [-CMClientMinVersion <String>]
   [-CheckSpeed <Boolean>]
   [-Speed <Int32>]
   -Name <String>
   [-Description <String>]
   [-ContinueOnError]
   [-Disable]
   [-Condition <IResultObject[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Add the Check Readiness step to a task sequence. Use this step to verify that the target computer meets the specified deployment prerequisite conditions. For more information on this task sequence step, see About task sequence steps.

Note

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

Examples

Example 1

{{ Add example description here }}

{{ Add example code here }}

Parameters

-CheckCMClientMinVersion

Use this parameter to enable or disable the following setting in the Check Readiness task sequence step: Minimum client version. Use the parameter CMClientMinVersion to set the specific client version number.

Type:Boolean
Aliases:CheckClientMinVersion
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CheckMaxOSVersion

Use this parameter to enable or disable the following setting in the Check Readiness task sequence step: Maximum OS version. Use the parameter MaxOSVersion to set the specific OS version number.

Type:Boolean
Aliases:EnableCheckMaxOSVersion
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CheckMemory

Use this parameter to enable or disable the following setting in the Check Readiness task sequence step: Minimum memory (MB). Use the parameter Memory to set the specific memory size.

Type:Boolean
Aliases:EnableCheckMemory
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CheckMinOSVersion

Use this parameter to enable or disable the following setting in the Check Readiness task sequence step: Minimum OS version. Use the parameter MinOSVersion to set the specific OS version number.

Type:Boolean
Aliases:EnableCheckMinOSVersion
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CheckNetworkConnected

Use this parameter to enable or disable the following setting in the Check Readiness task sequence step: Network adapter connected

Type:Boolean
Aliases:NetworkConnected
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CheckNetworkWired

Use this parameter to enable or disable the following setting in the Check Readiness task sequence step: Network adapter is not wireless

Type:Boolean
Aliases:NetworkWired
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CheckOS

Use this parameter to enable or disable the following setting in the Check Readiness task sequence step: Current OS to be refreshed is. Use the parameter OS to set the specific OS type.

Type:Boolean
Aliases:EnableCheckOSType
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CheckOSArchitecture

Use this parameter to enable or disable the following setting in the Check Readiness task sequence step: Architecture of current OS. Use the parameter OSArchitecture to set the specific architecture type.

Type:Boolean
Aliases:EnableCheckOSArchitecture
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CheckOSLanguageId

Use this parameter to enable or disable the following setting in the Check Readiness task sequence step: Language of current OS. Use the parameter OSLanguageID to set the specific language.

Type:Boolean
Aliases:EnableOSLanguageId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CheckPowerState

Use this parameter to enable or disable the following setting in the Check Readiness task sequence step: AC power plugged in.

Type:Boolean
Aliases:NotBattery
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CheckSpace

Use this parameter to enable or disable the following setting in the Check Readiness task sequence step: Minimum free disk space (MB). Use the parameter DiskSpace to set the specific size.

Type:Boolean
Aliases:EnableCheckFreeDiskSpace
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CheckSpeed

Use this parameter to enable or disable the following setting in the Check Readiness task sequence step: Minimum processor speed (MHz). Use the parameter Speed to set the specific speed.

Type:Boolean
Aliases:EnableCheckProcessorSpeed
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CheckUefi

Applies to version 2006 and later. Use this parameter to enable or disable the following setting in the Check Readiness task sequence step: Computer is in UEFI mode.

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

Use this parameter to configure the specific client version. Specify the client version in the following format: 5.00.8913.1005. Use the parameter CheckCMClientMinVersion to enable or disable the check.

Type:String
Aliases:ClientMinVersion
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Condition

Specify a condition object to use with this step.

Type:IResultObject[]
Aliases:Conditions
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:None
Accept pipeline input:False
Accept wildcard characters:False
-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.

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

Specify an optional description for this task sequence step.

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

Add this parameter to disable this task sequence step.

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

Use this parameter to configure the specific size for the minimum free disk space check. Specify an integer value for the size in MB. Use the parameter CheckSpace to enable or disable the check.

Type:Int32
Aliases:MinimumFreeDiskSpace
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
-MaxOSVersion

Use this parameter to configure the specific OS version. Specify the maximum OS version with major version, minor version, and build number. For example, 10.0.18356. Use the parameter CheckMaxOSVersion to enable or disable the check.

Type:String
Aliases:CurrentMaxOSVersion
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Memory

Use this parameter to configure the specific size for the minimum memory check. Specify an integer value for the size in MB. Use the parameter CheckMemory to enable or disable the check.

Type:Int32
Aliases:MinimumMemory
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MinOSVersion

Use this parameter to configure the specific OS version. Specify the minimum OS version with major version, minor version, and build number. For example, 10.0.16299. Use the parameter CheckMinOSVersion to enable or disable the check.

Type:String
Aliases:CurrentMinOSVersion
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

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

Type:String
Aliases:StepName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OS

Use this parameter to configure the specific OS type: Client or Server. Use the parameter CheckOS to enable or disable the check.

Type:OSType
Aliases:CurrentOSType
Accepted values:Client, Server
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OSArchitecture

Use this parameter to configure the specific OS architecture: Arch32 for 32-bit or Arch64 for 64-bit. Use the parameter CheckOSArchitecture to enable or disable the check.

Type:OSArch
Aliases:CurrentOSArchitecture
Accepted values:Arch32, Arch64
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OSLanguageId

Use this parameter to configure the specific OS language. This check compares the language ID to the OSLanguage property of the Win32_OperatingSystem WMI class on the client. For example, 1033 for English (United States). Use the parameter CheckOSLanguageId to enable or disable the check.

Type:Int32
Aliases:LanguageId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Speed

Use this parameter to configure the specific speed for the minimum processor speed check. Specify an integer value for the speed in MHz. Use the parameter CheckSpeed to enable or disable the check.

Type:Int32
Aliases:MinimumProcessorSpeed
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:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

IResultObject