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

説明

このコマンドレットは、Format および Partition Disk タスク シーケンス ステップで使用する ディスク パーティション オブジェクト を作成します。 このコマンドレットを使用してパーティション設定を定義し、New-CMTSStepPartitionDiskまたはSet-CMTSStepPartitionDiskコマンドレットの -PartitionSettingパラメーターを使用してそのオブジェクトを使用します。

このコマンドレットで使用する switch パラメーターに基づいて、次の種類のパーティション設定オブジェクトを作成できます。

  • PartitionPrimary: プライマリ パーティション
  • PartitionEfi EFI パーティション
  • PartitionExtended: 拡張パーティション
  • PartitionHidden: 非表示パーティション
  • PartitionLogical: 論理パーティション
  • PartitionMsr: MSR パーティション
  • PartitionRecovery: 回復パーティション

パーティション スイッチ パラメーターを指定しない場合、コマンドレットはプライマリ パーティション設定オブジェクトを作成します。

詳細については、「Format and Partition Disk: Volume 」を参照してください

例 1: EFI パーティションの設定を作成する

この例では 、500 MBEFIパーティションの設定を作成し 、partEfi 変数として保存します。

$partEfi = New-CMTSPartitionSetting -Name "EFI" -PartitionEfi -Size 500 -SizeUnit MB

例 2: MSR パーティションの設定を作成する

この例では 、128 MBMSRパーティションの設定を作成し 、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 の ステップを取得 します。

次に、最初のパーティション設定を表示するには、パーティション オブジェクトの配列である Partition プロパティ SMS_TaskSequence_PartitionSettings します。

$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

コマンドレットを実行する前に確認メッセージを表示します。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableDriveLetterAssignment

Configuration Manager がパーティションにドライブ文字を割り当て可能にするには、この true パラメーターを設定します。

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

-EnableQuickFormat

Configuration Manager が true パーティションの簡単な形式を実行するには、このパラメーターを設定します。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IsBootPartition

このパラメーターを設定 true して、このパーティションをブート パーティションに設定します。

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

-Name

パーティションの名前を指定します。

Type:String
Aliases:PartitionName, VolumeName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PartitionEfi

このパラメーターを追加して、パーティションの種類 を EFI にします

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PartitionExtended

パーティションの種類を拡張するには、このパラメーター を追加します

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PartitionFileSystem

パーティションの書式を設定するファイル システムを指定します。

Type:FileSystemType
Accepted values:Ntfs, Fat32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PartitionHidden

パーティションの種類を非表示にする場合は、このパラメーターを 追加します

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PartitionLogical

パーティションの種類を論理にする場合は、このパラメーターを 追加します

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PartitionMsr

パーティションの種類を MSR にする場合は、このパラメーター を追加します

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PartitionPrimary

パーティションの種類を Primary にするには、このパラメーターを 追加します

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PartitionRecovery

パーティションの種類を回復するには、このパラメーターを 追加します

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Size

パーティションのサイズの整数値を指定します。 このパラメーターは 、-SizeUnit パラメーターと一緒に使用 します。 -SizeUnit が指定されている場合は、このパラメーターに 1 ~ Percent 100 の数値を指定します。 SizeUnit がまたはの MB 場合 GB は、特定のパーティション サイズの番号を指定します。

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SizeUnit

サイズの単位の種類を指定します。 Size パラメーターと一緒に このパラメーターを使用 します。

  • Percent: -Size を使用 して、ディスク上の残りの空き領域の割合にパーティションを設定します。

  • MB または GB : -Size を使用して 、パーティションの特定のサイズを設定します。

Type:SizeUnitType
Accepted values:MB, GB, Percent
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Variable

既定では、Configuration Manager は次に使用可能なドライブ文字をこのパーティションに割り当てします。 このドライブ文字を将来使用するために保存するには、このパラメーターを使用してカスタム タスク シーケンス変数を設定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

入力

なし

出力

IResultObject

メモ

この戻り値オブジェクトとそのプロパティの詳細については、「SMS_TaskSequence_PartitionSettings WMI クラス」を参照してください