New-CMTSStepPrestartCheck

模組:

ConfigurationManager

建立 [ 檢查整備 程度] 步驟，您可以將其新增至工作順序。

Syntax

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 參數來設定特定的用戶端版本號碼。

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 以啟用 目前作業系統的語言檢查。 使用 參數 OSLanguageID 來設定特定語言。

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

-CheckPowerState

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

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 語言。 這項檢查會比較語言識別項與用戶端上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 類別。

相關連結

• Get-CMTSStepPrestartCheck
• Remove-CMTSStepPrestartCheck
• Set-CMTSStepPrestartCheck
• 關於工作順序步驟：檢查整備程度