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 コマンドレットを使用して、タスク シーケンスにステップを追加します。 この手順の詳細については、「 タスク シーケンスの手順について: 準備状況を確認する」を参照してください。
注:
Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>
)。 詳細については、「作業の 開始」を参照してください。
例
例 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 パラメーターを使用します。
Type: | Boolean |
Aliases: | CheckClientMinVersion |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckMaxOSVersion
[最大 OS バージョン] チェックを有効にするには、このパラメーターを に$true
設定します。 MaxOSVersion パラメーターを使用して、特定の OS バージョン番号を設定します。
Type: | Boolean |
Aliases: | EnableCheckMaxOSVersion |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckMemory
最小メモリ (MB) チェックを有効にするには、このパラメーターを に$true
設定します。 パラメーター Memory を使用して、特定のメモリ サイズを設定します。
Type: | Boolean |
Aliases: | EnableCheckMemory |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckMinOSVersion
[最小 OS バージョン] チェックを有効にするには、このパラメーターを に$true
設定します。 パラメーター 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 を使用して、特定の OS の種類を設定します。
Type: | Boolean |
Aliases: | EnableCheckOSType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckOSArchitecture
[現在の OS のアーキテクチャ] チェックを有効にするには、このパラメーターを に$true
設定します。 パラメーター OSArchitecture を使用して、特定のアーキテクチャの種類を設定します。
Type: | Boolean |
Aliases: | EnableCheckOSArchitecture |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckOSLanguageId
現在の OS の言語のチェックを有効にするには、このパラメーターを に$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
[最小空きディスク領域 (MB)] チェックを有効にするには、このパラメーターを に$true
設定します。 DiskSpace パラメーターを使用して、特定のサイズを設定します。
Type: | Boolean |
Aliases: | EnableCheckFreeDiskSpace |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckSpeed
[最小プロセッサ速度 (MHz)] チェックを有効にするには、このパラメーターを に$true
設定します。 パラメーター Speed を使用して、特定の速度を設定します。
Type: | Boolean |
Aliases: | EnableCheckProcessorSpeed |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckTpmActivated
バージョン 2111 以降に適用されます。 TPM 2.0 以上がアクティブ化チェックを有効にするには、このパラメーターを に$true
設定します。
Type: | Boolean |
Aliases: | TpmActivated |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckTpmEnabled
バージョン 2111 以降に適用されます。 TPM 2.0 以上が有効になっているチェックを有効にするには、このパラメーターを に$true
設定します。
Type: | Boolean |
Aliases: | TpmEnabled |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckUefi
バージョン 2006 以降に適用されます。 コンピューターが UEFI モードのチェックを有効にするには、このパラメーターを に$true
設定します。
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
この手順で使用する条件オブジェクトを指定します。 このオブジェクトを取得するには、タスク シーケンス条件コマンドレットのいずれかを使用します。 たとえば、 Get-CMTSStepConditionVariable です。
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
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
32 ビットまたは Arch64
64 ビットの特定の OS アーキテクチャArch32
を構成するには、このパラメーターを使用します。 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
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
None
出力
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_TaskSequence_PrestartCheckAction」を参照してください。
関連リンク
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示