Get-PSDrive

Başvuru

Modül:: Microsoft.PowerShell.Management

Geçerli oturumdaki sürücüleri alır.

Sözdizimi

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

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

Description

Get-PSDrive cmdlet'i sürücüleri geçerli oturumda alır. Oturumda belirli bir sürücüyü veya tüm sürücüleri alabilirsiniz.

Bu cmdlet aşağıdaki sürücü türlerini alır:

Ağ paylaşımlarına eşlenen sürücüler de dahil olmak üzere bilgisayardaki Windows mantıksal sürücüleri.
PowerShell sağlayıcıları tarafından kullanıma sunulan sürücüler (Sertifika:, İşlev:ve Diğer Ad: sürücüler gibi) ve HKLM: ve HKCU: Windows PowerShell Kayıt Defteri sağlayıcısı tarafından kullanıma sunulan sürücüler.
Oturumda belirtilen geçici sürücüler ve New-PSDrive cmdlet'ini kullanarak oluşturduğunuz kalıcı eşlenmiş ağ sürücüleri.

Windows PowerShell 3.0'dan başlayarak, cmdlet'in New-PSDrive parametresi, yerel bilgisayara kaydedilen ve diğer oturumlarda kullanılabilen eşlenmiş ağ sürücüleri oluşturabilir. Daha fazla bilgi için bkz. New-PSDrive.

Ayrıca, Windows PowerShell 3.0'da, bilgisayara bir dış sürücü bağlandığında, Windows PowerShell yeni sürücüyü temsil eden dosya sistemine otomatik olarak bir PSDrive ekler. Windows PowerShell'i yeniden başlatmanız gerekmez. Benzer şekilde, bir dış sürücünün bilgisayar bağlantısı kesildiğinde, Windows PowerShell kaldırılan sürücüyü temsil eden PSDrive'ı otomatik olarak siler.

Örnekler

Örnek 1: Geçerli oturumda sürücüleri alma

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

Bu komut geçerli oturumdaki sürücüleri alır.

Çıktıda sabit sürücü (C:), CD-ROM sürücüsü (D:) ve Windows PowerShell sağlayıcıları tarafından kullanıma sunulan sürücüler gösterilir (Diğer Ad:, Sertifika:, Env:, İşlev:, HKCU:, HKLM:ve Değişken:).

Örnek 2: Bilgisayara sürücü alma

PS C:\foo> Get-PSDrive D

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

Bu komut bilgisayarda D: sürücüsünü alır. Komuttaki sürücü harfinin arkasına iki nokta üst üste yazılmadığını unutmayın.

Örnek 3: Windows PowerShell FileSystem sağlayıcısı tarafından desteklenen tüm sürücüleri alma

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

Bu komut, Windows PowerShell FileSystem sağlayıcısı tarafından desteklenen tüm sürücüleri alır. Bu, New-PSDrive cmdlet'ini kullanarak oluşturduğunuz sabit sürücüleri, mantıksal bölümleri, eşlenen ağ sürücülerini ve geçici sürücüleri içerir.

Örnek 4: Bir sürücünün Windows PowerShell sürücü adı olarak kullanımda olup olmadığını denetleyin

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
}

Bu komut, X sürücüsünün windows PowerShell sürücü adı olarak zaten kullanımda olup olmadığını denetler. Değilse, komut New-PSDrive cmdlet'ini kullanarak HKLM:\SOFTWARE kayıt defteri anahtarına eşlenen geçici bir sürücü oluşturur.

Örnek 5: Dosya sistem sürücülerinin türlerini karşılaştırma

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

Bu örnek, Get-PSDrive tarafından görüntülenen dosya sistemi sürücülerinin türlerini diğer yöntemler kullanılarak görüntülenenlerle karşılaştırır. Bu örnek, Windows PowerShell'de sürücüleri görüntülemenin farklı yollarını gösterir ve New-PSDrive cmdlet'i kullanılarak oluşturulan oturuma özgü sürücülerin yalnızca Windows PowerShell'de erişilebilir olduğunu gösterir.

İlk komut, oturumdaki tüm dosya sistemi sürücülerini almak için Get-PSDrive kullanır. Buna sabit sürücüler (C: ve D:), New-PSDrive parametresi kullanılarak oluşturulan eşlenmiş bir ağ sürücüsü (G:) ve New-PSDrive parametresi olmadan kullanılarak oluşturulan bir PowerShell sürücüsü (T:) dahildir.

net use komutu Windows eşlenmiş ağ sürücülerini görüntüler, bu durumda yalnızca G sürücüsünü görüntüler. New-PSDrivetarafından oluşturulan X: sürücüsünü görüntülemez. G: sürücüsünün \\Music\GratefulDead ile de eşlendiğini gösterir.

Üçüncü komut, Microsoft .NET Framework System.IO.DriveInfo sınıfının GetDrives yöntemini kullanır. Bu komut, G: sürücüsü de dahil olmak üzere Windows dosya sistemi sürücülerini alır, ancak New-PSDrivetarafından oluşturulan sürücüleri almaz.

Dördüncü komut, Get-CimInstance sınıfının örneklerini almak için cmdlet'ini kullanır. A:, C:, D:, E:ve G: sürücülerini döndürür, ancak New-PSDrivetarafından oluşturulan sürücüleri döndürmez.

Son komut, Get-CimInstance sınıfının örneklerini görüntülemek için cmdlet'ini kullanır. net usegibi, yalnızca New-PSDrivetarafından oluşturulan kalıcı G: sürücüsünü döndürür.

Parametreler

-LiteralName

Sürücünün adını belirtir.

LiteralName değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Ad kaçış karakterleri içeriyorsa, tek tırnak içine alın. Tek tırnak işaretleri, Windows PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.

Tür:	String[]
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Name

Dize dizisi olarak, bu cmdlet'in işlemde aldığı sürücülerin adını veya adını belirtir. Sürücü adını veya harfi iki nokta üst üste (:) olmadan yazın.

Tür:	String[]
Position:	0
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-PSProvider

Dize dizisi olarak Windows PowerShell sağlayıcısını belirtir. Bu cmdlet yalnızca bu sağlayıcı tarafından desteklenen sürücüleri alır. FileSystem, Registry veya Certificate gibi bir sağlayıcının adını yazın.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Scope

Bu cmdlet'in sürücüleri aldığı kapsamı belirtir.

Bu parametre için kabul edilebilir değerler şunlardır:

Küresel
Yöresel
Betik
geçerli kapsama göre bir sayıdır (0, 0 geçerli kapsam, 1 ise onun üst kapsamıdır). "Yerel" varsayılandır.

Daha fazla bilgi için bkz. about_Scopes.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

PSDriveInfo

Bu cmdlet, oturumdaki sürücüleri temsil eden nesneleri döndürür.

Notlar

PowerShell, Get-PSDriveiçin aşağıdaki diğer adları içerir:

Tüm platformlar:
- gdr
Bu cmdlet, herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için Get-PSProvider cmdlet'ini kullanın. Daha fazla bilgi için bkz. about_Providers.
New-PSDrive cmdlet'in Kalıcı parametresi kullanılarak oluşturulan eşlenmiş ağ sürücüleri bir kullanıcı hesabına özeldir. Yönetici olarak çalıştır seçeneğiyle veya başka bir kullanıcının kimlik bilgileriyle başlatılan oturumlarda oluşturduğunuz eşlenmiş ağ sürücüleri, açık kimlik bilgileri olmadan veya geçerli kullanıcının kimlik bilgileriyle başlatılan oturumlarda görünmez.