Remove-PSDrive

モジュール:

Microsoft.PowerShell.Management

一時的な PowerShell ドライブを削除し、マップされたネットワーク ドライブを切断します。

構文

Remove-PSDrive
      [-Name] <String[]>
      [-PSProvider <String[]>]
      [-Scope <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<CommonParameters>]

Remove-PSDrive
      [-LiteralName] <String[]>
      [-PSProvider <String[]>]
      [-Scope <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<CommonParameters>]

説明

Remove-PSDrive コマンドレットは、New-PSDrive コマンドレットを使用して作成された一時的な PowerShell ドライブを削除します。

Windows PowerShell 3.0 以降では、Remove-PSDriveでは、New-PSDriveの Persist パラメーターを使用して作成されたドライブなど、マップされたネットワーク ドライブ切断されます。

Remove-PSDrive では、Windows の物理ドライブまたは論理ドライブを削除できません。

Windows PowerShell 3.0 以降では、外部ドライブがコンピューターに接続されると、PowerShell は新しいドライブを表す PSDrive をファイル システムに自動的に追加します。 PowerShell を再起動する必要はありません。 同様に、外部ドライブがコンピューターから切断されると、削除されたドライブを表す PSDrive が PowerShell によって自動的に削除されます。

例

例 1: ファイル システム ドライブを削除する

このコマンドは、 smpという名前の一時ファイル システム ドライブを削除します。

Remove-PSDrive -Name smp

例 2: マップされたネットワーク ドライブを削除する

このコマンドでは、 Remove-PSDrive を使用して、 X: を切断し、マップされたネットワーク ドライブ S: します。

Get-PSDrive X, S | Remove-PSDrive

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Force

現在の PowerShell ドライブを削除します。

型:	SwitchParameter
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LiteralName

ドライブの名前を指定します。

LiteralName の値は、型指定されたとおりに使用されます。 ワイルドカードとして解釈される文字はありません。 名前にエスケープ文字が含まれている場合は、単一引用符 (') で囲みます。 単一引用符は、文字をエスケープ シーケンスとして解釈しないように PowerShell に指示します。

型:	String[]
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

削除するドライブの名前を指定します。 ドライブ名の後にコロン (:) を入力しないでください。

型:	String[]
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	True

-PSProvider

PSProvider オブジェクトの配列を指定します。 このコマンドレットは、指定した PowerShell プロバイダーに関連付けられているすべてのドライブを削除して切断します。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Scope

ドライブのスコープを指定します。 このパラメーターに使用できる値は、 Global、 Local、 Script、または現在のスコープを基準とした数値です。 スコープの数 0 スコープの数を指定します。 現在のスコープ番号が 0 され、その親が 1。 詳細については、「 about_Scopes」を参照してください。

型:	String
配置:	Named
規定値:	Local
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-UseTransaction

アクティブなトランザクションのコマンドが含まれます。 このパラメーターは、トランザクションが進行中の場合のみ有効です。 詳細については、「 about_Transactions」を参照してください。

型:	SwitchParameter
Aliases:	usetx
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

PSDriveInfo

Get-PSDrive コマンドレットなどのドライブ オブジェクトをこのコマンドレットにパイプできます。

出力

None

このコマンドレットは、出力を返しません。

メモ

Windows PowerShell には、 Remove-PSDriveの次のエイリアスが含まれています。

• rdr

• Remove-PSDrive コマンドレットは、PowerShell プロバイダーによって公開されるデータを操作するように設計されています。 セッション内のプロバイダーを一覧表示するには、 Get-PSProvider コマンドレットを使用します。 詳細については、「 about_Providers」を参照してください。

関連リンク

• Get-PSDrive
• New-PSDrive
• about_Providers