Remove-PSDrive

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

構文

Name (既定)

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

LiteralName

Remove-PSDrive
    [-LiteralName] <String[]>
    [-PSProvider <String[]>]
    [-Scope <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<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
規定値:False
ワイルドカードのサポート:False
DontShow:False
エイリアス:Cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Force

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

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-LiteralName

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

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

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

LiteralName
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Name

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

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:True
DontShow:False

パラメーター セット

Name
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-PSProvider

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

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Scope

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

パラメーターのプロパティ

型:String
規定値:Local
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
エイリアス:wi

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。

入力

PSDriveInfo

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

出力

None

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

メモ

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

  • すべてのプラットフォーム:

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