New-CMTSStepPrestartCheck

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

语法

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 参数 Splatsparameters 变量中。

接下来,它为 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 类型: ClientServer。 使用参数 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 类