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]
      [<CommonParameters>]
Remove-PSDrive
      [-LiteralName] <String[]>
      [-PSProvider <String[]>]
      [-Scope <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Remove-PSDrive usuwa tymczasowe dyski programu PowerShell utworzone przy użyciu polecenia cmdlet New-PSDrive.

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

Remove-PSDrive nie można 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 używa Remove-PSDrive do rozłączenia X: i S: zamapowanych dysków sieciowych.

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ść LiteralName 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 tego parametru to: Global, Locali Script, lub liczba względem bieżącego zakresu. Zakresy 0 przez liczbę zakresów. Bieżący numer zakresu jest 0, a jego element nadrzędny jest 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

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

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 polecenia cmdlet Get-PSDrive.

Dane wyjściowe

None

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

Uwagi

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

  • Wszystkie platformy:

    • rdr

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