Aracılığıyla paylaş

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, 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 Persist 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ı sabit sürücüyü (C:), CD-ROM sürücüsünü (D:) ve Windows PowerShell sağlayıcıları tarafından kullanıma sunulan sürücüleri gösterir (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 dosya sistemi 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 cmdlet'ini New-PSDrive 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, tarafından Get-PSDrive 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ı 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 kullanır Get-PSDrive . Buna sabit sürücüler (C: ve D:), öğesinin Persist parametresi kullanılarak oluşturulan eşlenmiş bir ağ sürücüsü (G:) ve Persist parametresi olmadan kullanılarak New-PSDrive oluşturulan bir PowerShell sürücüsü (T:) New-PSDrivedahildir.

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. tarafından New-PSDriveoluş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 tarafından New-PSDriveoluşturulan sürücüleri almaz.

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

Son komut, Win32_NetworkConnection sınıfının örneklerini görüntülemek için cmdlet'ini kullanırGet-CimInstance. Net use gibi, yalnızca tarafından New-PSDriveoluş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 (:) 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 parametrenin kabul edilebilir değerleri şunlardır:

  • Global
  • Yerel
  • Komut Dosyası
  • 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 için aşağıdaki diğer adları Get-PSDriveiç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 cmdlet'ini Get-PSProvider kullanın. Daha fazla bilgi için bkz . about_Providers.

  • New-PSDrive cmdlet'inin Persist 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.