Remove-PSDrive
一時的な PowerShell ドライブを削除し、マップされたネットワーク ドライブを切断します。
構文
Name (既定)
Remove-PSDrive
[-Name] <String[]>
[-PSProvider <String[]>]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
LiteralName
Remove-PSDrive
[-LiteralName] <String[]>
[-PSProvider <String[]>]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
説明
Remove-PSDrive コマンドレットは、New-PSDrive コマンドレットを使用して作成された一時的な PowerShell ドライブを削除します。
Windows PowerShell 3.0 以降では、Remove-PSDrive は、Persist の a New-PSDrive パラメーターを使用して作成されたドライブを含むが、これらに限定されない、マップされたネットワーク ドライブも切断します。
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 |
| Aliases: | 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 |
-UseTransaction
アクティブなトランザクションにコマンドを含みます。 このパラメーターは、トランザクションが進行中の場合にのみ有効です。 詳細については、「about_Transactions」を参照してください。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | usetx |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
PSDriveInfo
Get-PSDrive コマンドレットのドライブ オブジェクトなどを Remove-PSDrive コマンドレットにパイプ処理できます。
出力
None
このコマンドレットによる戻り値はありません。
メモ
-
Remove-PSDriveコマンドレットは、PowerShell プロバイダーによって公開されるデータを操作するように設計されています。 セッション内のプロバイダーを一覧表示するには、Get-PSProviderコマンドレットを使用します。 詳細については、about_Providersを参照してください。