Delen via

Get-PSDrive

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee haalt u stations op in de huidige sessie.

Syntaxis

Get-PSDrive
   [[-Name] <String[]>]
   [-Scope <String>]
   [-PSProvider <String[]>]
   [<CommonParameters>]
Get-PSDrive
   [-LiteralName] <String[]>
   [-Scope <String>]
   [-PSProvider <String[]>]
   [<CommonParameters>]

Description

De Get-PSDrive cmdlet haalt de stations op in de huidige sessie. U kunt een bepaald station of alle stations in de sessie ophalen.

Met deze cmdlet worden de volgende typen stations opgehaald:

  • Logische Windows-stations op de computer, inclusief stations die zijn toegewezen aan netwerkshares.
  • Stations die worden weergegeven door PowerShell-providers (zoals de stations Certificate:, Function:en Alias: stations) en de HKLM- en HKCU-stations die beschikbaar worden gesteld door de Windows PowerShell-registerprovider.
  • Door de sessie opgegeven tijdelijke stations en permanente toegewezen netwerkstations die u maakt met behulp van de New-PSDrive cmdlet.

Vanaf Windows PowerShell 3.0 kan de parameter Persistent van de cmdlet New-PSDrive toegewezen netwerkstations maken die zijn opgeslagen op de lokale computer en beschikbaar zijn in andere sessies. Zie New-PSDrive voor meer informatie.

Vanaf Windows PowerShell 3.0, wanneer een extern station is verbonden met de computer, voegt Windows PowerShell automatisch een PSDrive toe aan het bestandssysteem dat het nieuwe station vertegenwoordigt. U hoeft Windows PowerShell niet opnieuw op te starten. Op dezelfde manier verwijdert Windows PowerShell, wanneer een extern station is losgekoppeld van de computer, automatisch de PSDrive die het verwijderde station vertegenwoordigt.

Voorbeelden

Voorbeeld 1: Stations ophalen in de huidige sessie

PS C:\> Get-PSDrive

Name           Used (GB)     Free (GB) Provider      Root
----           ---------     --------- --------      ----
Alias                                  Alias
C                 202.06      23718.91 FileSystem    C:\
Cert                                   Certificate   \
D                1211.06     123642.32 FileSystem    D:\
Env                                    Environment
Function                               Function
HKCU                                   Registry      HKEY_CURRENT_USER
HKLM                                   Registry      HKEY_LOCAL_MACHINE
Variable                               Variable

Met deze opdracht worden de stations in de huidige sessie opgeslagen.

De uitvoer toont de harde schijf (C:), CD-ROM station (D:) en de stations die worden weergegeven door de Windows PowerShell-providers (Alias:, Cert:, Env:, Function:, HKCU:, HKLM:, en Variable:).

Voorbeeld 2: Een station op de computer ophalen

PS C:\foo> Get-PSDrive D

Name           Used (GB)     Free (GB) Provider      Root
----           ---------     --------- --------      ----
D                1211.06     123642.32 FileSystem    D:\

Met deze opdracht wordt het station D: op de computer. Houd er rekening mee dat de stationsletter in de opdracht niet wordt gevolgd door een dubbele punt.

Voorbeeld 3: Alle stations ophalen die worden ondersteund door de Windows PowerShell-bestandssysteemprovider

PS C:\> Get-PSDrive -PSProvider FileSystem
Name           Used (GB)     Free (GB) Provider      Root
----           ---------     --------- --------      ----
A                                                    A:\
C                 202.06      23718.91 FileSystem    C:\
D                1211.06     123642.32 FileSystem    D:\
G                 202.06        710.91 FileSystem    \\Music\GratefulDead

Met deze opdracht worden alle stations ophaalt die worden ondersteund door de Windows PowerShell-bestandssysteemprovider. Dit omvat vaste stations, logische partities, toegewezen netwerkstations en tijdelijke stations die u maakt met behulp van de New-PSDrive-cmdlet.

Voorbeeld 4: Controleren of een station wordt gebruikt als naam van een Windows PowerShell-station

if (Get-PSDrive X -ErrorAction SilentlyContinue) {
    Write-Host 'The X: drive is already in use.'
} else {
    New-PSDrive -Name X -PSProvider Registry -Root HKLM:\SOFTWARE
}

Met deze opdracht wordt gecontroleerd of het X-station al wordt gebruikt als naam van een Windows PowerShell-station. Als dit niet het probleem is, gebruikt de opdracht de New-PSDrive cmdlet om een tijdelijk station te maken dat is toegewezen aan de registersleutel HKLM:\SOFTWARE.

Voorbeeld 5: De typen bestandssysteemstations vergelijken

PS C:\> Get-PSDrive -PSProvider FileSystem
Name           Used (GB)     Free (GB) Provider      Root
----           ---------     --------- --------      ----
A                                                    A:\
C                 202.06      23718.91 FileSystem    C:\
D                1211.06     123642.32 FileSystem    D:\
G                 202.06        710.91 FileSystem    \\Music\GratefulDead
X                                      Registry      HKLM:\Network

PS C:\> net use
New connections will be remembered.
Status       Local     Remote                    Network
-------------------------------------------------------------------------------
OK           G:        \\Server01\Public         Microsoft Windows Network

PS C:\> [System.IO.DriveInfo]::GetDrives() | Format-Table
Name DriveType DriveFormat IsReady AvailableFreeSpace TotalFreeSpace TotalSize     RootDirectory VolumeLabel
---- --------- ----------- ------- ------------------ -------------- ---------     ------------- -----------
A:\    Network               False                                                 A:\
C:\      Fixed NTFS          True  771920580608       771920580608   988877418496  C:\           Windows
D:\      Fixed NTFS          True  689684144128       689684144128   1990045179904 D:\           Big Drive
E:\      CDRom               False                                                 E:\
G:\    Network NTFS          True      69120000           69120000       104853504 G:\           GratefulDead

PS N:\> Get-CimInstance -Class Win32_LogicalDisk

DeviceID DriveType ProviderName   VolumeName         Size          FreeSpace
-------- --------- ------------   ----------         ----          ---------
A:       4
C:       3                        Windows            988877418496  771926069248
D:       3                        Big!              1990045179904  689684144128
E:       5
G:       4         \\Music\GratefulDead              988877418496  771926069248


PS C:\> Get-CimInstance -Class Win32_NetworkConnection
LocalName RemoteName            ConnectionState Status
--------- ----------            --------------- ------
G:        \\Music\GratefulDead  Connected       OK

In dit voorbeeld worden de typen bestandssysteemstations vergeleken die worden weergegeven door Get-PSDrive met behulp van andere methoden. In dit voorbeeld ziet u verschillende manieren om stations weer te geven in Windows PowerShell en ziet u dat sessiespecifieke stations die zijn gemaakt met behulp van de cmdlet New-PSDrive alleen toegankelijk zijn in Windows PowerShell.

De eerste opdracht gebruikt Get-PSDrive om alle bestandssysteemstations in de sessie op te halen. Dit omvat de vaste stations (C: en D:), een toegewezen netwerkstation (G:) dat is gemaakt met behulp van de parameter Persistent van New-PSDriveen een PowerShell-station (T:) dat is gemaakt met behulp van New-PSDrive zonder de parameter Persistent.

De net use opdracht geeft Windows toegewezen netwerkstations weer, in dit geval alleen het G-station. Het X: station dat is gemaakt door New-PSDrivewordt niet weergegeven. Het laat zien dat het station G: ook is toegewezen aan \\Music\GratefulDead.

De derde opdracht maakt gebruik van de methode GetDrives van de klasse Microsoft .NET Framework System.IO.Drive Info. Met deze opdracht worden de Windows-bestandssysteemstations, inclusief station G:, maar de stations worden niet gemaakt door New-PSDrive.

De vierde opdracht maakt gebruik van de cmdlet Get-CimInstance om de exemplaren van de Win32_LogicalDisk-klasse op te halen. Het retourneert de stations A:, C:, D:, E:, en G: maar niet de stations die zijn gemaakt door New-PSDrive.

De laatste opdracht gebruikt de Get-CimInstance cmdlet om de exemplaren van de Win32_NetworkConnection klasse weer te geven. Net zoals net use, retourneert het alleen de permanente G: station gemaakt door New-PSDrive.

Parameters

-LiteralName

Hiermee geeft u de naam van het station.

De waarde van LiteralName wordt precies zoals deze wordt getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als de naam escapetekens bevat, plaatst u deze tussen enkele aanhalingstekens. Enkele aanhalingstekens geven Windows PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u, als tekenreeksmatrix, de naam of naam van stations op die door deze cmdlet in de bewerking wordt geplaatst. Typ de stationsnaam of letter zonder dubbele punt (:).

Type:String[]
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PSProvider

Hiermee geeft u, als een tekenreeksmatrix, de Windows PowerShell-provider op. Deze cmdlet haalt alleen de stations op die door deze provider worden ondersteund. Typ de naam van een provider, zoals Bestandssysteem, Register of Certificaat.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Scope

Hiermee geeft u het bereik op waarin deze cmdlet de stations ophaalt.

De acceptabele waarden voor deze parameter zijn:

  • Globaal
  • Lokaal
  • Script
  • een getal ten opzichte van het huidige bereik (0 tot het aantal bereiken, waarbij 0 het huidige bereik is en 1 het bovenliggende bereik is). 'Lokaal' is de standaardwaarde.

Zie about_Scopesvoor meer informatie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

PSDriveInfo

Met deze cmdlet worden objecten geretourneerd die de stations in de sessie vertegenwoordigen.

Notities

PowerShell bevat de volgende aliassen voor Get-PSDrive:

  • Alle platforms:

    • gdr

  • Deze cmdlet is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Gebruik de cmdlet Get-PSProvider om de providers weer te geven die beschikbaar zijn in uw sessie. Zie about_Providersvoor meer informatie.

  • Toegewezen netwerkstations die zijn gemaakt met behulp van de Persistent parameter van de New-PSDrive cmdlet zijn specifiek voor een gebruikersaccount. Toegewezen netwerkstations die u maakt in sessies die zijn gestart met de optie Uitvoeren als administrator of met de referenties van een andere gebruiker, zijn niet zichtbaar in sessies die worden gestart zonder expliciete referenties of met de referenties van de huidige gebruiker.