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>] 説明
このコマンドレットは、新しい Check Readiness ステップ オブジェクトを作成します。 次に、 Add-CMTaskSequenceStep コマンドレットを使用して、タスク シーケンスにステップを追加します。 この手順の詳細については、「 タスク シーケンスの手順について: 準備状況を確認する」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1
この例では、最初にコマンドレット パラメーターを 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 パラメーターを使用します。
| 型: | Boolean |
| Aliases: | CheckClientMinVersion |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckMaxOSVersion
[最大 OS バージョン] チェックを有効にするには、このパラメーターを $true に設定します。
MaxOSVersion パラメーターを使用して、特定の OS バージョン番号を設定します。
| 型: | Boolean |
| Aliases: | EnableCheckMaxOSVersion |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckMemory
最小メモリ (MB) チェックを有効にするには、このパラメーターを $true に設定します。
パラメーター Memory を使用して、特定のメモリ サイズを設定します。
| 型: | Boolean |
| Aliases: | EnableCheckMemory |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckMinOSVersion
[最小 OS バージョン] チェックを有効にするには、このパラメーターを $true に設定します。 パラメーター MinOSVersion を使用して、特定の OS バージョン番号を設定します。
| 型: | Boolean |
| Aliases: | EnableCheckMinOSVersion |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckNetworkConnected
ネットワーク アダプター接続チェックを有効にするには、このパラメーターを $true に設定します。
| 型: | Boolean |
| Aliases: | NetworkConnected |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckNetworkWired
ネットワーク アダプターがワイヤレス チェックでないことを有効にするには、このパラメーターを $true に設定します。
| 型: | Boolean |
| Aliases: | NetworkWired |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckOS
このパラメーターを $true に設定して、OS の種類 (クライアントまたはサーバー) のチェックを有効にします。 パラメーター OS を使用して、特定の OS の種類を設定します。
| 型: | Boolean |
| Aliases: | EnableCheckOSType |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckOSArchitecture
[現在の OS のアーキテクチャ] チェックを有効にするには、このパラメーターを $true に設定します。 パラメーター OSArchitecture を使用して、特定のアーキテクチャの種類を設定します。
| 型: | Boolean |
| Aliases: | EnableCheckOSArchitecture |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckOSLanguageId
現在の OS の言語のチェックを有効にするには、このパラメーターを $true に設定します。 パラメーター OSLanguageID を 使用して、特定の言語を設定します。
| 型: | Boolean |
| Aliases: | EnableOSLanguageId |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckPowerState
このパラメーターを $true に設定して、 AC 電源の差し込みチェックを 有効にします。
| 型: | Boolean |
| Aliases: | NotBattery |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckSpace
[最小空きディスク領域 (MB)] チェックを有効にするには、このパラメーターを $true に設定します。 DiskSpace パラメーターを使用して、特定のサイズを設定します。
| 型: | Boolean |
| Aliases: | EnableCheckFreeDiskSpace |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckSpeed
[最小プロセッサ速度 (MHz)] チェックを有効にするには、このパラメーターを $true に設定します。
パラメーター Speed を使用して、特定の速度を設定します。
| 型: | Boolean |
| Aliases: | EnableCheckProcessorSpeed |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckTpmActivated
バージョン 2111 以降に適用されます。
TPM 2.0 以上がアクティブ化チェックを有効にするには、このパラメーターを $true に設定します。
| 型: | Boolean |
| Aliases: | TpmActivated |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckTpmEnabled
バージョン 2111 以降に適用されます。
TPM 2.0 以上が有効になっているチェックを有効にするには、このパラメーターを $true に設定します。
| 型: | Boolean |
| Aliases: | TpmEnabled |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CheckUefi
バージョン 2006 以降に適用されます。 コンピューターが UEFI モードのチェックを有効にするには、このパラメーターを $true に設定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CMClientMinVersion
このパラメーターを使用して、特定のクライアント バージョンを構成します。 クライアント バージョンを次の形式で指定します: 5.00.8913.1005。
CheckCMClientMinVersion パラメーターを使用して、チェックを有効または無効にします。
| 型: | String |
| Aliases: | ClientMinVersion |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Condition
この手順で使用する条件オブジェクトを指定します。 このオブジェクトを取得するには、タスク シーケンス条件コマンドレットのいずれかを使用します。 たとえば、 Get-CMTSStepConditionVariable です。
| 型: | IResultObject[] |
| Aliases: | Conditions |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ContinueOnError
このパラメーターを追加して、ステップ オプション [ エラー時に続行] を有効にします。 このオプションを有効にすると、ステップが失敗した場合、タスク シーケンスは続行されます。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
このタスク シーケンス ステップの説明 (省略可能) を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Disable
このタスク シーケンス ステップを無効にするには、このパラメーターを追加します。
| 型: | SwitchParameter |
| Aliases: | DisableThisStep |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DiskSpace
このパラメーターを使用して、空きディスク領域の最小チェックの特定のサイズを構成します。 サイズの整数値を MB 単位で指定します。 CheckSpace パラメーターを使用して、チェックを有効または無効にします。
| 型: | Int32 |
| Aliases: | MinimumFreeDiskSpace |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MaxOSVersion
このパラメーターを使用して、特定の OS バージョンを構成します。 メジャー バージョン、マイナー バージョン、ビルド番号を使用して、OS の最大バージョンを指定します。 たとえば、「 10.0.18356 」のように入力します。
CheckMaxOSVersion パラメーターを使用して、チェックを有効または無効にします。
| 型: | String |
| Aliases: | CurrentMaxOSVersion |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Memory
最小メモリ チェックの特定のサイズを構成するには、このパラメーターを使用します。 サイズの整数値を MB 単位で指定します。 CheckMemory パラメーターを使用して、チェックを有効または無効にします。
| 型: | Int32 |
| Aliases: | MinimumMemory |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MinOSVersion
このパラメーターを使用して、特定の OS バージョンを構成します。 メジャー バージョン、マイナー バージョン、ビルド番号を含む最小 OS バージョンを指定します。 たとえば、「 10.0.16299 」のように入力します。
CheckMinOSVersion パラメーターを使用して、チェックを有効または無効にします。
| 型: | String |
| Aliases: | CurrentMinOSVersion |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
この手順の名前を指定して、タスク シーケンスで識別します。
| 型: | String |
| Aliases: | StepName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OS
特定の OS の種類 ( Client または Server) を構成するには、このパラメーターを使用します。
CheckOS パラメーターを使用して、チェックを有効または無効にします。
| 型: | OSType |
| Aliases: | CurrentOSType |
| 指定可能な値: | Client, Server |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OSArchitecture
32 ビットの場合は Arch32 、64 ビットの場合は Arch64 という特定の OS アーキテクチャを構成するには、このパラメーターを使用します。
CheckOSArchitecture パラメーターを使用して、チェックを有効または無効にします。
| 型: | OSArch |
| Aliases: | CurrentOSArchitecture |
| 指定可能な値: | Arch32, Arch64 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OSLanguageId
このパラメーターを使用して、特定の OS 言語を構成します。 このチェックでは、言語 ID をクライアント上の Win32_OperatingSystem WMI クラスの OSLanguage プロパティと比較します。 たとえば、英語 (米国) の1033。
CheckOSLanguageId パラメーターを使用して、チェックを有効または無効にします。
| 型: | Int32 |
| Aliases: | LanguageId |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Speed
このパラメーターを使用して、プロセッサの最小速度チェックの特定の速度を構成します。 速度の整数値を MHz で指定します。 CheckSpeed パラメーターを使用して、チェックを有効または無効にします。
| 型: | Int32 |
| Aliases: | MinimumProcessorSpeed |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_TaskSequence_PrestartCheckAction」を参照してください。