Get-PSDrive
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 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, 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 VariableMet 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\GratefulDeadMet 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 Cmdlet New-PSDrive.
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 dat niet het is, gebruikt de opdracht de New-PSDrive cmdlet om een tijdelijk station te maken dat is toegewezen aan de HKLM:\SOFTWARE-registersleutel.
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 OKIn dit voorbeeld worden de typen bestandssysteemstations vergeleken die worden weergegeven met Get-PSDrive de stations die worden weergegeven 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 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 de parameter Persistent .
Met de opdracht net use worden toegewezen Windows-netwerkstations weergegeven, in dit geval alleen het G-station. Het geeft niet het X:-station weer dat is gemaakt door New-PSDrive. 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:, maar de stations worden niet gemaakt door New-PSDrive.
De vierde opdracht gebruikt de Get-CimInstance cmdlet 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 als netgebruik 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 exact gebruikt zoals deze is 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 een 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 aanvaardbare 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_Scopes voor 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
Met deze cmdlet worden objecten geretourneerd die de stations in de sessie vertegenwoordigen.
Notities
PowerShell bevat de volgende aliassen voor Get-PSDrive:
Alle platformen:
gdr
Deze cmdlet is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Gebruik de
Get-PSProvidercmdlet 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 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.
