New-CMTSPartitionSetting
[ディスクのフォーマットとパーティション分割] タスク シーケンス ステップで使用するディスク パーティション オブジェクトを作成します。
構文
New-CMTSPartitionSetting
[-EnableDriveLetterAssignment <Boolean>]
[-EnableQuickFormat <Boolean>]
[-IsBootPartition <Boolean>]
[-Name <String>]
[-PartitionFileSystem <FileSystemType>]
[-PartitionPrimary]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-Variable <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTSPartitionSetting
[-Name <String>]
[-PartitionEfi]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTSPartitionSetting
[-Name <String>]
[-PartitionExtended]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTSPartitionSetting
[-Name <String>]
[-PartitionHidden]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTSPartitionSetting
[-Name <String>]
[-PartitionLogical]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTSPartitionSetting
[-Name <String>]
[-PartitionMsr]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTSPartitionSetting
[-Name <String>]
[-PartitionRecovery]
[-Size <Int32>]
[-SizeUnit <SizeUnitType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このコマンドレットは、[ディスクのフォーマット] および [パーティション ディスク] タスク シーケンス ステップで使用する ディスク パーティション オブジェクトを作成します。 このコマンドレットを使用してパーティション設定を定義し、New-CMTSStepPartitionDisk コマンドレットまたは Set-CMTSStepPartitionDisk コマンドレットの -PartitionSetting パラメーターでそのオブジェクトを使用します。
このコマンドレットで使用する switch パラメーターに基づいて、次の種類のパーティション設定オブジェクトを作成できます。
- PartitionPrimary: プライマリ パーティション
- PartitionEfi EFI パーティション
- PartitionExtended: 拡張パーティション
- PartitionHidden: 非表示パーティション
- PartitionLogical: 論理パーティション
- PartitionMsr: MSR パーティション
- PartitionRecovery: 回復パーティション
パーティション スイッチ パラメーターを指定しない場合、コマンドレットはプライマリ パーティション設定オブジェクトを作成します。
詳細については、「 フォーマットとパーティション ディスク: ボリューム」を参照してください。
例
例 1: EFI パーティションの設定を作成する
この例では、500 MB の EFI パーティションの設定を作成し、partEfi 変数として保存します。
$partEfi = New-CMTSPartitionSetting -Name "EFI" -PartitionEfi -Size 500 -SizeUnit MB例 2: MSR パーティションの設定を作成する
この例では、128 MB の MSR パーティションの設定を作成し、partMsr 変数として保存します。
$partMsr = New-CMTSPartitionSetting -Name "MSR" -PartitionMsr -Size 128 -SizeUnit MB例 3: Windows プライマリ パーティションの設定を作成する
次の使用例は、 Windows プライマリ パーティションの設定を作成し、 partWin 変数として保存します。
$partWin = New-CMTSPartitionSetting -Name "Windows" -PartitionPrimary -Size 99 -SizeUnit Percent -EnableDriveLetterAssignment $true -EnableQuickFormat $true -PartitionFileSystem NTFS -IsBootPartition $true例 4: 回復パーティションの設定を作成する
この例では、残りのディスク領域の 100% である Recovery パーティションの設定を作成し、partMsr 変数として保存します。
$partRec = New-CMTSPartitionSetting -Name "Recovery" -PartitionRecovery -Size 100 -SizeUnit Percent例 5: ステップのパーティション設定の詳細を表示する
この例では、最初に 、$tsOsd 変数内のタスク シーケンス オブジェクトを取得します。 次に、その変数を入力オブジェクトとして渡して、 Format と Partition Disk の手順を取得します。
次に、最初のパーティション設定を表示するには、SMS_TaskSequence_PartitionSettings オブジェクトの配列である Partition プロパティを参照します。
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsStepNameFormatDisk = "Partition Disk 0 - UEFI"
$tsStepFormatDisk = Get-CMTSStepPartitionDisk -InputObject $tsOsd -StepName $tsStepNameFormatDisk
$tsStepFormatDisk.Partitions[0]このプロセスを使用して、ステップまたはタスク シーケンス間でパーティション設定をコピーできます。 このパーティション設定オブジェクトを変数として保存し、別の手順に追加します。
パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnableDriveLetterAssignment
Configuration Manager がパーティションにドライブ文字を割り当てできるようにするには、このパラメーターを true に設定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnableQuickFormat
Configuration Manager でパーティションの簡易形式を実行できるようにするには、このパラメーターを true に設定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-IsBootPartition
このパーティションをブート パーティションにするには、このパラメーターを true に設定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
パーティションの名前を指定します。
| 型: | String |
| Aliases: | PartitionName, VolumeName |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PartitionEfi
パーティションの種類を EFI にするには、このパラメーターを追加します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PartitionExtended
パーティションの種類を 拡張するには、このパラメーターを追加します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PartitionFileSystem
パーティションをフォーマットするファイル システムを指定します。
| 型: | FileSystemType |
| 指定可能な値: | Ntfs, Fat32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PartitionHidden
パーティションの種類を非表示にするには、このパラメーターを追加 します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PartitionLogical
このパラメーターを追加して、パーティションの種類を [論理] にします。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PartitionMsr
このパラメーターを追加して、パーティションの種類 を MSR にします。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PartitionPrimary
このパラメーターを追加して、パーティションの種類を Primary にします。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PartitionRecovery
このパラメーターを追加して、パーティションの種類を Recovery にします。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Size
パーティションのサイズに整数値を指定します。 このパラメーターは、 -SizeUnit パラメーターと共に使用します。
SizeUnit がPercentの場合は、このパラメーターに 1 から 100 までの数値を指定します。
SizeUnit がMBまたはGB場合は、特定のパーティション サイズの数値を指定します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SizeUnit
サイズの単位の種類を指定します。 このパラメーターは、 -Size パラメーターと共に使用します。
Percent: -Size を 使用して、パーティションをディスク上の残りの空き領域の割合に設定します。MBまたはGB: -Size を使用してパーティションの特定のサイズを設定します。
| 型: | SizeUnitType |
| 指定可能な値: | MB, GB, Percent |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Variable
既定では、Configuration Manager はこのパーティションに次に使用可能なドライブ文字を割り当てます。 今後使用するためにこのドライブ文字を保存するには、このパラメーターを使用してカスタム タスク シーケンス変数を設定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_TaskSequence_PartitionSettings」を参照してください。