Clear-Disk

Clear-Disk

Cleans a disk by removing all partition information and un-initializing it, erasing all data on the disk.

構文

Parameter Set: ByNumber
Clear-Disk [-Number] <UInt32[]> [-AsJob] [-CimSession <CimSession[]> ] [-PassThru] [-RemoveData] [-RemoveOEM] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByName
Clear-Disk [-AsJob] [-CimSession <CimSession[]> ] [-FriendlyName <String[]> ] [-PassThru] [-RemoveData] [-RemoveOEM] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByPath
Clear-Disk -Path <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-PassThru] [-RemoveData] [-RemoveOEM] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByUniqueId
Clear-Disk -UniqueId <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-PassThru] [-RemoveData] [-RemoveOEM] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Clear-Disk -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-PassThru] [-RemoveData] [-RemoveOEM] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Clear-Disk cmdlet clears the disk by removing the partition and volume information.

If the disk contains active data volumes, then the RemoveData parameter is required as this will delete all data from the specified disk. This cmdlet will not clear OEM recovery partitions unless ForceOEM parameter is also specified.

パラメーター

-AsJob

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。既定値は、ローカル コンピューターで実行中の現在のセッションです。

-FriendlyName<String[]>

Specifies a friendly name of the disk to clear.

-InputObject<CimInstance[]>

Specifies the disk object to clear. Enter a Disk CIM object, which you can get by using the Get-Disk cmdlet.

-Number<UInt32[]>

Specifies the disk number of the disk on which to perform the clear operation. For a list of available disks, see the Get-Disk cmdlet.

-PassThru

Specifies that the cmdlet should output an object representing a disk. By default, this cmdlet does not generate any output.

-Path<String[]>

Specifies the path of the disk to clear.

-RemoveData

Enabes the removal of all of the data on the disk.

-RemoveOEM

Enables the removal of any OEM recovery partitions from the disk.

-ThrottleLimit<Int32>

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。

-UniqueId<String[]>

Specifies the UniqueID of the disk to clear.

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

• Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_Disk

  You can pipe a Disk object to the InputObject parameter.

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

• Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_Disk

  When you specify the Passthru parameter, this cmdlet outputs an object representing the disk that you cleared.

注

• Microsoft.Management.Infrastructure.CimInstance オブジェクトは、Windows Management Instrumentation (WMI) オブジェクトを表示するラッパー クラスです。シャープ記号 (#) の後のパスは、基になる WMI オブジェクトの名前空間とクラス名です。

例

Example 1: Clear a blank disk

This example clears disk number one only if it does not contain both data or OEM partitions.

PS C:\> Clear-Disk -Number 1

Example 2: Clear a disk with data partitions

This example clears the disk if it has data partitions, but not if it also has OEM partitions.

PS C:\> Clear-Disk -Number 1 –RemoveData

Clear a disk with data and OEM partitions

This example clears the disk regardless of whether it contains data or OEM partitions.

PS C:\> Clear-Disk -Number 1 -RemoveData –RemoveOEM

関連トピック

Format-Volume

Get-Disk

Initialize-Disk

New-Partiton

Set-Disk

Update-Disk