Remove-PSDrive
一時的な PowerShell ドライブを削除し、マップされたネットワーク ドライブを切断します。
構文
Remove-PSDrive
[-Name] <String[]>
[-PSProvider <String[]>]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
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 |
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 |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Get-PSDrive
コマンドレットなどのドライブ オブジェクトをこのコマンドレットにパイプできます。
出力
None
このコマンドレットは、出力を返しません。
メモ
PowerShell には、 Remove-PSDrive
の次のエイリアスが含まれています。
すべてのプラットフォーム:
rdr
Remove-PSDrive
コマンドレットは、PowerShell プロバイダーによって公開されるデータを操作するように設計されています。 セッション内のプロバイダーを一覧表示するには、Get-PSProvider
コマンドレットを使用します。 詳細については、「 about_Providers」を参照してください。
関連リンク
PowerShell