Udostępnij za pośrednictwem

Remove-PSDrive

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

Usuwa tymczasowe dyski programu PowerShell i rozłącza zamapowane 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 Windows PowerShell 3.0, Remove-PSDrive również rozłącza mapowane dyski sieciowe, w tym, ale nie tylko, dyski utworzone przy użyciu parametru Persist .New-PSDrive

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

Począwszy od wersji Windows PowerShell 3.0, gdy dysk zewnętrzny jest podłączony do komputera, program PowerShell automatycznie dodaje usługę PSDrive do systemu plików reprezentującego 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 X: i S: mapowanych dysków sieciowych.

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 typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli nazwa zawiera znaki ucieczki, należy ją ująć w znaki pojedynczego cudzysłowu ('). 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 tego parametru to: Global, Locali Script, lub liczba względna względem bieżącego zakresu. Zakresy są numerami 0 za pośrednictwem 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 polecenia cmdlet można przekazać Remove-PSDrive potok obiektu dysku, takiego jak jeden z Get-PSDrive polecenia cmdlet.

Dane wyjściowe

None

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

Uwagi

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