共用方式為


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

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