Remove-PSDrive
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
, Local
i 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
Do tego polecenia cmdlet można przekazać potok obiektu dysku, takiego jak 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 Remove-PSDrive
programu :
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żyjGet-PSProvider
polecenia cmdlet . Aby uzyskać więcej informacji, zobacz about_Providers.