Udostępnij za pośrednictwem

Remove-PSDrive

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

Usuwa tymczasowe dyski programu PowerShell i rozłącza mapowane dyski sieciowe.

Składnia

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>]

Opis

Polecenie Remove-PSDrive cmdlet usuwa tymczasowe dyski programu PowerShell, które zostały utworzone przy użyciu New-PSDrive polecenia cmdlet .

Począwszy od programu Windows PowerShell 3.0, Remove-PSDrive rozłącza również zamapowane dyski sieciowe, w tym dyski utworzone przy użyciu parametru Persist programu New-PSDrive.

Remove-PSDrive program nie może usunąć dysków fizycznych lub logicznych systemu Windows.

Począwszy od programu Windows PowerShell 3.0, gdy dysk zewnętrzny jest podłączony do komputera, program PowerShell automatycznie dodaje usługę PSDrive do systemu plików, który reprezentuje nowy dysk. Nie trzeba ponownie uruchamiać programu PowerShell. Podobnie, gdy dysk zewnętrzny zostanie odłączony od komputera, program PowerShell automatycznie usunie dysk PSDrive reprezentujący usunięty dysk.

Przykłady

Przykład 1. Usuwanie dysku systemu plików

To polecenie usuwa tymczasowy dysk systemu plików o nazwie smp.

Remove-PSDrive -Name smp

Przykład 2. Usuwanie zamapowanych dysków sieciowych

To polecenie służy Remove-PSDrive do odłączania dysków sieciowych X: i S: mapowanych.

Get-PSDrive X, S | Remove-PSDrive

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Usuwa bieżący dysk programu PowerShell.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LiteralName

Określa nazwę dysku.

Wartość LiterałuNazwa jest używana dokładnie tak, jak typizowane. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli nazwa zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów ('). Znaki pojedynczego cudzysłowu instruują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwy dysków do usunięcia. Nie należy wpisywać dwukropka (:) po nazwie dysku.

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-PSProvider

Określa tablicę obiektów PSProvider . To polecenie cmdlet usuwa i rozłącza wszystkie dyski skojarzone z określonym dostawcą programu PowerShell.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Scope

Określa zakres dysku. Dopuszczalne wartości dla tego parametru to: Global, Locali , Scriptlub liczba względem bieżącego zakresu. Zakresy są numerami 0 według liczby zakresów. Bieżący numer zakresu to 0 , a jego element nadrzędny to 1. Aby uzyskać więcej informacji, zobacz about_Scopes.

Typ:String
Position:Named
Domyślna wartość:Local
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-UseTransaction

Zawiera polecenie w aktywnej transakcji. Ten parametr jest prawidłowy tylko wtedy, gdy transakcja jest w toku. Aby uzyskać więcej informacji, zobacz about_Transactions.

Typ:SwitchParameter
Aliasy:usetx
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSDriveInfo

Do tego polecenia cmdlet można przekazać potok obiektu dysku, na przykład z Get-PSDrive polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

Program Windows PowerShell zawiera następujące aliasy dla programu Remove-PSDrive:

  • rdr

  • Polecenie Remove-PSDrive cmdlet jest przeznaczone do pracy z danymi udostępnianymi przez dowolnego dostawcę programu PowerShell. Aby wyświetlić listę dostawców w sesji, użyj Get-PSProvider polecenia cmdlet . Aby uzyskać więcej informacji, zobacz about_Providers.