Delen via

Get-PSDrive

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee haalt u stations op in de huidige sessie.

Syntax

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 ophaalt:

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

Vanaf Windows PowerShell 3.0 kan de parameter Persistent van de New-PSDrive cmdlet 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 voegt Windows PowerShell vanaf Windows PowerShell 3.0 automatisch een PSDrive toe aan het bestandssysteem dat het nieuwe station vertegenwoordigt. U hoeft Windows PowerShell niet opnieuw op te starten. Op dezelfde manier wordt, wanneer een extern station wordt losgekoppeld van de computer, Windows PowerShell automatisch de PSDrive die het verwijderde station vertegenwoordigt, verwijderd.

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:), het cd-rom-station (D:) en de stations die beschikbaar worden gesteld 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 haalt u 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 haalt u alle stations op 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 cmdlet New-PSDrive.

Voorbeeld 4: Controleer of een station wordt gebruikt als Windows PowerShell stationnaam

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 een Windows PowerShell stationnaam. Als dat niet zo 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 die worden weergegeven door Get-PSDrive vergeleken met de typen die worden weergegeven met behulp van andere methoden. In dit voorbeeld ziet u verschillende manieren om stations in Windows PowerShell weer te geven 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 .

Met de opdracht net use worden toegewezen Windows-netwerkstations weergegeven, in dit geval alleen het G-station. Het X:-station dat door is gemaakt New-PSDrive, wordt 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.DriveInfo. Met deze opdracht worden de Windows-bestandssysteemstations, inclusief station G:, opgeslagen, maar niet de stations die zijn gemaakt door New-PSDrive.

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

De laatste opdracht gebruikt de Get-CimInstance cmdlet om de exemplaren van de klasse Win32_NetworkConnection weer te geven. Net als bij nettogebruik retourneert het alleen het permanente G:-station dat is gemaakt door New-PSDrive.

Parameters

-LiteralName

Hiermee geeft u de naam van het station.

De waarde van LiteralName wordt precies gebruikt zoals deze wordt getypt. Geen tekens worden geïnterpreteerd als jokertekens. Als de naam escape-tekens bevat, plaatst u deze tussen enkele aanhalingstekens. Enkele aanhalingstekens geven aan dat Windows PowerShell geen tekens als escapereeksen moet interpreteren.

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

-Name

Hiermee geeft u, als een tekenreeksmatrix, de naam van stations op die deze cmdlet in de bewerking ophaalt. Typ de naam of letter van het station zonder dubbele punt (:).

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

-PSProvider

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

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

-Scope

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

De aanvaardbare waarden voor deze parameter zijn:

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

Zie about_Scopes voor meer informatie.

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

Invoerwaarden

None

U kunt geen objecten doorspezen naar deze cmdlet.

Uitvoerwaarden

PSDriveInfo

Deze cmdlet retourneert objecten die de stations in de sessie vertegenwoordigen.

Notities

  • Deze cmdlet is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Gebruik Get-PSProvider de cmdlet om de providers weer te geven die beschikbaar zijn in uw sessie. Zie about_Providers voor meer informatie.
  • Toegewezen netwerkstations die zijn gemaakt met behulp van de parameter Persistent van de cmdlet New-PSDrive zijn specifiek voor een gebruikersaccount. Toegewezen netwerkstations die u maakt in sessies die zijn gestart met de optie Als administrator uitvoeren 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.