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>]

Description

此 Cmdlet 會建立新的 檢查整備 步驟物件。 然後使用 Add-CMTaskSequenceStep Cmdlet 將步驟新增至工作順序。 如需此步驟的詳細資訊，請 參閱關於工作順序步驟：檢查整備程度。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。

範例

範例 1

此範 例會先 將 Cmdlet 參數展開至 parameters 變數。

接下來，它會建立 [檢查整 備 程度] 步驟的 物件，並在 參數中傳遞值集合。

然後，它會取得工作順序物件，並將這個新步驟新增至索引 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 以啟用 目前操作系統的語言檢查。 使用 參數OSLanguageID 來設定特定語言。

類型:	Boolean
別名:	EnableOSLanguageId
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CheckPowerState

將此參數設定為 ， $true 以啟用 AC 電源外掛程式 檢查。

類型:	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語言。 這項檢查會比較語言標識碼與用戶端上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
• 關於工作順序步驟：檢查整備程度