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 设置特定的客户端版本号。

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

-CheckMaxOSVersion

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

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

-CheckMemory

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

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

-CheckMinOSVersion

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

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

-CheckNetworkConnected

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

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

-CheckNetworkWired

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

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

-CheckOS

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

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

-CheckOSArchitecture

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

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

-CheckOSLanguageId

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

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

-CheckPowerState

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

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

-CheckSpace

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

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

-CheckSpeed

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

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

-CheckTpmActivated

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

Type:	Boolean
Aliases:	TpmActivated
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CheckTpmEnabled

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

Type:	Boolean
Aliases:	TpmEnabled
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CheckUefi

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

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

-CMClientMinVersion

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

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

-Condition

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

Type:	IResultObject[]
Aliases:	Conditions
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContinueOnError

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

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

-Description

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

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

-Disable

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

Type:	SwitchParameter
Aliases:	DisableThisStep
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

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

-DiskSpace

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

Type:	Int32
Aliases:	MinimumFreeDiskSpace
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

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

-MaxOSVersion

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

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

-Memory

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

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

-MinOSVersion

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

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

-Name

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

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

-OS

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

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

-OSArchitecture

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

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

-OSLanguageId

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

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

-Speed

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

Type:	Int32
Aliases:	MinimumProcessorSpeed
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

输出

IResultObject

备注

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

Share via