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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Usuwa bieżący dysk programu PowerShell.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PSProvider

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 PowerShell zawiera następujące aliasy dla programu Remove-PSDrive:

  • Wszystkie platformy:

    • 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.