Delen via

Get-PSDrive

  • Referentie
Module:
Microsoft.PowerShell.Management

Haalt stations op in de huidige sessie.

Syntax

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

Description

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

Deze cmdlet haalt de volgende typen stations op:

  • Logische Windows-stations op de computer, inclusief stations die zijn toegewezen aan netwerkshares.
  • Stations die worden weergegeven door Windows 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 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.

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

Voorbeelden

Voorbeeld 1: Stations ophalen in de huidige sessie

PS C:\> Get-PSDrive

Name       Provider      Root
----       --------      ----
Alias      Alias
C          FileSystem    C:\
Cert       Certificate   \
D          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.

In de uitvoer worden de harde schijf (C:), het cd-romstation (D:) en de stations weergegeven door de Windows PowerShell-providers (Alias:, Cert:, Env:, Function:, HKCU:, HKLM:en Variable:).

Voorbeeld 2: Een station op de computer ophalen

PS C:\> Get-PSDrive D

Name       Provider      Root
----       --------      ----
D          FileSystem    D:\

Met deze opdracht wordt het station D: op de computer opgeslagen. 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       Provider      Root
----       --------      ----
C          FileSystem    C:\
D          FileSystem    D:\
X          FileSystem    X:\
Y          FileSystem    \\Server01\Public
Z          FileSystem    C:\Windows\System32

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 New-PSDrive cmdlet.

Voorbeeld 4: Controleren of een station wordt gebruikt als een 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       Provider      Root
----       --------      ----
C          FileSystem    C:\
D          FileSystem    D:\
X          FileSystem    X:\
Y          FileSystem    \\Server01\Public
Z          FileSystem    C:\Windows\System32

PS C:\> net use
New connections will be remembered.

Status       Local     Remote                    Network
-------------------------------------------------------------------------------
X:        \\Server01\Public         Microsoft Windows Network

PS C:\> [System.IO.DriveInfo]::GetDrives()

Name               : C:\
DriveType          : Fixed
DriveFormat        : NTFS
IsReady            : True
AvailableFreeSpace : 39831498752
TotalFreeSpace     : 39831498752
TotalSize          : 79900368896
RootDirectory      : C:\
VolumeLabel        :
Name               : D:\
DriveType          : CDRom
DriveFormat        :
IsReady            : False
AvailableFreeSpace :
TotalFreeSpace     :
TotalSize          :
RootDirectory      : D:\
VolumeLabel        :
Name               : X:\
DriveType          : Network
DriveFormat        : NTFS
IsReady            : True
AvailableFreeSpace : 36340559872
TotalFreeSpace     : 36340559872
TotalSize          : 36413280256
RootDirectory      : X:\
VolumeLabel        : D_Drive

PS C:\> Get-WmiObject Win32_LogicalDisk

DeviceID     : C:
DriveType    : 3
ProviderName :
FreeSpace    : 39831252992
Size         : 79900368896
VolumeName   :
DeviceID     : D:
DriveType    : 5
ProviderName :
FreeSpace    :
Size         :
VolumeName   :
DeviceID     : X:
DriveType    : 4
ProviderName : \\server01\public
FreeSpace    : 36340559872
Size         : 36413280256
VolumeName   : D_Drive

PS C:\> Get-WmiObject Win32_NetworkConnection

LocalName                     RemoteName
--------------               ------------
x:                            \\server01\public

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 tijdelijke, sessiespecifieke stations die zijn gemaakt met behulp van de cmdlet New-PSDrive alleen toegankelijk zijn in Windows PowerShell.

De eerste opdracht maakt gebruik van Get-PSDrive om alle bestandssysteemstations in de sessie op te halen. Dit omvat de vaste stations (C: en D:), een toegewezen netwerkstation (X:) dat is gemaakt met behulp van de parameter Persistent van New-PSDrive en twee tijdelijke Windows PowerShell stations (Y: en Z:) die zijn gemaakt met new-PSDrive zonder de persistent parameter.

Een net use-opdracht, waarmee toegewezen Windows-netwerkstations worden weergegeven, geeft alleen het X-station weer. De stations Y: en Z: die zijn gemaakt door New-PSDrive worden niet weergegeven. Hier ziet u dat het station X: ook is toegewezen aan \\Server01\Public.

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 X:, opgeslagen, maar niet de tijdelijke stations gemaakt door New-PSDrive.

De vierde opdracht maakt gebruik van de cmdlet Get-WmiObject om de exemplaren van de klasse Win32_LogicalDisk op te halen. De stations C:, D: en X: worden geretourneerd, maar niet de tijdelijke stations die door New-PSDrive zijn gemaakt.

De laatste opdracht gebruikt de cmdlet Get-WmiObject om de exemplaren van de klasse Win32_NetworkConnection weer te geven. Net als net use retourneert het alleen het permanente station X: dat is gemaakt door New-PSDrive.

Parameters

-LiteralName

Hiermee geeft u de naam van het station.

De waarde van LiteralName wordt precies zo gebruikt als 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 aan dat Windows PowerShell geen tekens als escape-reeksen 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 of 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. 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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Scope

Hiermee geeft u het bereik 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 (https://go.microsoft.com/fwlink/?LinkID=113260) voor meer informatie.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UseTransaction

Hiermee wordt de opdracht opgenomen in de actieve transactie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie about_Transactions voor meer informatie.

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

Invoerwaarden

None

U kunt geen objecten doorsnijden 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 de cmdlet Get-PSProvider 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 worden 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.