New-CMTSStepPrestartCheck

模块:

ConfigurationManager

创建 “检查就绪情况” 步骤，可添加到任务序列。

语法

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

说明

此 cmdlet 将创建新的 Check Readiness 步骤对象。 然后使用 Add-CMTaskSequenceStep cmdlet 将步骤添加到任务序列。 有关此步骤的详细信息，请参阅 关于任务序列步骤：检查就绪情况。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1

此示例首先将 cmdlet 参数 Splats 到 parameters 变量中。

接下来，它为 Check Readiness 步骤创建一个 对象，并在 参数中传递值集合。

然后，它获取任务序列对象，并将此新步骤添加到索引 11 处的任务序列。

$parameters = @{
  Name = "Check Readiness"
  CheckMemory = $true
  Memory = 4096
  CheckSpeed = $true
  Speed = 1024
  CheckSpace = $true
  DiskSpace = 512000
  CheckOS = $true
  OS = "Client"
  CheckOSArchitecture = $true
  OSArchitecture = "Arch64"
  CheckMinOSVersion = $true
  MinOSVersion = "10.0.16299"
  CheckMaxOSVersion = $true
  MaxOSVersion = "10.0.99999"
  CheckCMClientMinVersion = $true
  CMClientMinVersion = "5.00.8913.1005"
  CheckOSLanguageId = $true
  OSLanguageID = 1033
  CheckPowerState = $true
  CheckNetworkConnected = $true
  CheckNetworkWired = $false
  CheckUefi = $true
}

$step = New-CMTSStepPrestartCheck @parameters

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

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

参数

-CheckCMClientMinVersion

将此参数设置为 $true 以启用 最小客户端版本 检查。 使用参数 CMClientMinVersion 设置特定的客户端版本号。

类型:	Boolean
别名:	CheckClientMinVersion
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckMaxOSVersion

将此参数设置为 以 $true 启用 最大 OS 版本 检查。 使用参数 MaxOSVersion 设置特定的 OS 版本号。

类型:	Boolean
别名:	EnableCheckMaxOSVersion
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckMemory

将此参数设置为 以 $true 启用 最小内存 (MB) 检查。 使用参数 Memory 设置特定的内存大小。

类型:	Boolean
别名:	EnableCheckMemory
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckMinOSVersion

将此参数设置为 $true 以启用 最低 OS 版本 检查。 使用参数 MinOSVersion 设置特定的 OS 版本号。

类型:	Boolean
别名:	EnableCheckMinOSVersion
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckNetworkConnected

将此参数设置为 以 $true 启用 网络适配器连接 检查。

类型:	Boolean
别名:	NetworkConnected
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckNetworkWired

将此参数设置为 $true 以启用 网络适配器不是无线 检查。

类型:	Boolean
别名:	NetworkWired
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckOS

将此参数设置为 $true 以启用对操作系统类型（客户端或服务器）的检查。 使用参数 OS 设置特定的 OS 类型。

类型:	Boolean
别名:	EnableCheckOSType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckOSArchitecture

将此参数设置为 以 $true 启用 当前 OS 的体系结构 检查。 使用参数 OSArchitecture 设置特定的体系结构类型。

类型:	Boolean
别名:	EnableCheckOSArchitecture
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckOSLanguageId

将此参数设置为 $true 以启用 当前 OS 语言检查。 使用参数 OSLanguageID 设置特定语言。

类型:	Boolean
别名:	EnableOSLanguageId
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckPowerState

将此参数设置为 $true 以启用 交流电源插入 检查。

类型:	Boolean
别名:	NotBattery
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckSpace

将此参数设置为 以 $true 启用 最小可用磁盘空间 (MB) 检查。 使用参数 DiskSpace 设置特定大小。

类型:	Boolean
别名:	EnableCheckFreeDiskSpace
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckSpeed

将此参数设置为 以 $true 启用 最低处理器速度 (MHz) 检查。 使用参数 Speed 设置特定速度。

类型:	Boolean
别名:	EnableCheckProcessorSpeed
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckTpmActivated

适用于版本 2111 及更高版本。 将此参数设置为 以 $true 启用 TPM 2.0 或更高版本的激活 检查。

类型:	Boolean
别名:	TpmActivated
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckTpmEnabled

适用于版本 2111 及更高版本。 将此参数设置为 $true 以启用 TPM 2.0 或更高版本的启用 检查。

类型:	Boolean
别名:	TpmEnabled
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CheckUefi

适用于版本 2006 及更高版本。 将此参数设置为 $true 以启用 计算机是否处于 UEFI 模式 检查。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CMClientMinVersion

使用此参数配置特定的客户端版本。 按以下格式指定客户端版本： 5.00.8913.1005。 使用参数 CheckCMClientMinVersion 启用或禁用检查。

类型:	String
别名:	ClientMinVersion
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Condition

指定要用于此步骤的条件对象。 若要获取此对象，请使用任务序列条件 cmdlet 之一。 例如 Get-CMTSStepConditionVariable。

类型:	IResultObject[]
别名:	Conditions
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ContinueOnError

添加此参数以启用步骤选项“ 出错时继续”。 启用此选项时，如果步骤失败，任务序列将继续。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Description

为此任务序列步骤指定可选说明。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Disable

添加此参数以禁用此任务序列步骤。

类型:	SwitchParameter
别名:	DisableThisStep
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DiskSpace

使用此参数可配置最小可用磁盘空间检查的特定大小。 指定大小的整数值（以 MB 为单位）。 使用参数 CheckSpace 启用或禁用检查。

类型:	Int32
别名:	MinimumFreeDiskSpace
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MaxOSVersion

使用此参数配置特定的 OS 版本。 使用主版本、次要版本和内部版本号指定最大 OS 版本。 例如，10.0.18356。 使用参数 CheckMaxOSVersion 启用或禁用检查。

类型:	String
别名:	CurrentMaxOSVersion
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Memory

使用此参数可配置最小内存检查的特定大小。 指定大小的整数值（以 MB 为单位）。 使用参数 CheckMemory 启用或禁用检查。

类型:	Int32
别名:	MinimumMemory
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MinOSVersion

使用此参数配置特定的 OS 版本。 使用主版本、次要版本和内部版本号指定最低 OS 版本。 例如，10.0.16299。 使用参数 CheckMinOSVersion 启用或禁用检查。

类型:	String
别名:	CurrentMinOSVersion
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定此步骤的名称，以便在任务序列中标识它。

类型:	String
别名:	StepName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OS

使用此参数配置特定的 OS 类型： Client 或 Server。 使用参数 CheckOS 启用或禁用检查。

类型:	OSType
别名:	CurrentOSType
接受的值:	Client, Server
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OSArchitecture

使用此参数配置特定的 OS 体系结构： Arch32 32 位或 Arch64 64 位。 使用参数 CheckOSArchitecture 启用或禁用检查。

类型:	OSArch
别名:	CurrentOSArchitecture
接受的值:	Arch32, Arch64
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OSLanguageId

使用此参数配置特定的 OS 语言。 此检查将语言 ID 与客户端上 Win32_OperatingSystem WMI 类的 OSLanguage 属性进行比较。 例如， 1033 对于 英语 (美国) 。 使用参数 CheckOSLanguageId 启用或禁用检查。

类型:	Int32
别名:	LanguageId
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Speed

使用此参数可配置最低处理器速度检查的特定速度。 指定速度的整数值（以 MHz 为单位）。 使用 参数 CheckSpeed 启用或禁用检查。

类型:	Int32
别名:	MinimumProcessorSpeed
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

输出

IResultObject

备注

有关此返回对象及其属性的详细信息，请参阅 SMS_TaskSequence_PrestartCheckAction服务器 WMI 类。

相关链接

• Get-CMTSStepPrestartCheck
• Remove-CMTSStepPrestartCheck
• Set-CMTSStepPrestartCheck
• 关于任务序列步骤：检查就绪情况