Get-PSDrive

  • Başvuru
Modül:
Microsoft.PowerShell.Management

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

Syntax

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

Description

Get-PSDrive Cmdlet, geçerli oturumdaki sürücüleri 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.
  • oturum tarafından 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 sürümünden başlayarak cmdlet'in New-PSDrivePersist 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 sürümünden başlayarak, 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 yeniden başlatmanız gerekmez. Benzer şekilde, bir dış sürücünün bilgisayarla 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 (Alias:, Cert:, Env:, Function:, HKCU:, HKLM:, and Variable:).

Ö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, bilgisayardaki D: sürücüsünü alır. Komuttaki sürücü harfinin ardından iki nokta üst üste gelmeyeceğini 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 sabit sürücüleri, mantıksal bölümleri, eşlenen ağ sürücülerini ve New-PSDrive cmdlet'ini kullanarak oluşturduğunuz 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 bir Windows PowerShell sürücüsü adı olarak zaten kullanımda olup olmadığını denetler. Aksi takdirde, komut cmdlet'ini New-PSDrive kullanarak HKLM:\SOFTWARE kayıt defteri anahtarına eşlenmiş 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 örnekte, Windows PowerShell'de sürücüleri görüntülemenin farklı yolları ve New-PSDrive cmdlet'i kullanılarak oluşturulan oturuma özgü sürücülerin yalnızca Windows PowerShell'de erişilebilir olduğu gösterilmektedir.

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

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 hiçbir karakteri kaçış dizisi olarak yorumlamamalarını söyler.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters: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.

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

-Scope

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

Bu parametrenin kabul edilebilir değerleri şunlardır:

  • Genel
  • Yerel
  • Komut Dosyası
  • geçerli kapsama göre bir sayıdır (kapsam sayısı üzerinden 0, burada 0 geçerli kapsam ve 1 onun üst öğesidir). "Yerel" varsayılandır.

Daha fazla bilgi için bkz. about_Scopes.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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 Get-PSDriveaş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 cmdlet'ini Get-PSProvider kullanın. Daha fazla bilgi için bkz. about_Providers.

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