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を参照してください。