Get-PSDrive
Получает диски в текущем сеансе.
Синтаксис
Get-PSDrive
[[-Name] <String[]>]
[-Scope <String>]
[-PSProvider <String[]>]
[<CommonParameters>]
Get-PSDrive
[-LiteralName] <String[]>
[-Scope <String>]
[-PSProvider <String[]>]
[<CommonParameters>]
Описание
Командлет Get-PSDrive
получает диски в текущем сеансе. Можно получить определенный диск или все диски в сеансе.
Этот командлет получает следующие типы дисков:
- Логические диски Windows на компьютере, включая диски, сопоставленные с общими сетевыми ресурсами.
- Диски, предоставляемые поставщиками PowerShell (например, диски Certificate:, Function:и Alias: ), а также HKLM: и HKCU: диски, предоставляемые поставщиком реестра Windows PowerShell.
- Временные диски, заданные сеансом, и постоянные сопоставленные сетевые диски, созданные с помощью командлета New-PSDrive.
Начиная с Windows PowerShell 3.0, параметр Persist командлета New-PSDrive
может создавать сопоставленные сетевые диски, сохраненные на локальном компьютере и доступные в других сеансах. Дополнительные сведения см. в статье New-PSDrive.
Кроме того, начиная с Windows PowerShell 3.0, когда внешний диск подключается к компьютеру, Windows PowerShell автоматически добавляет в файловую систему объект PSDrive, представляющий новый диск. Перезапускать Windows PowerShell не нужно. Аналогичным образом, когда внешний диск отключается от компьютера, Windows PowerShell автоматически удаляет объект PSDrive, представляющий удаленный диск.
Примеры
Пример 1. Получение дисков в текущем сеансе
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
Эта команда получает диски в текущем сеансе.
В выходных данных показаны жесткий диск (C:), дисковод КОМПАКТ-дисков (D:) и диски, предоставляемые поставщиками Windows PowerShell (Alias:, Cert:, Env:, Function:, HKCU:, HKLM:и Variable:).
Пример 2. Получение диска на компьютере
PS C:\foo> Get-PSDrive D
Name Used (GB) Free (GB) Provider Root
---- --------- --------- -------- ----
D 1211.06 123642.32 FileSystem D:\
Эта команда получает диск D: на компьютере. Обратите внимание, что за буквой диска в команде не следует двоеточие.
Пример 3. Получение всех дисков, поддерживаемых поставщиком файловой системы Windows PowerShell
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
Эта команда получает все диски, которые поддерживаются поставщиком FileSystem оболочки Windows PowerShell. Сюда входят фиксированные диски, логические секции, сопоставленные сетевые диски и временные диски, созданные с помощью командлета New-PSDrive.
Пример 4. Проверка использования диска в качестве имени Windows PowerShell диска
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
}
Эта команда проверяет, используется ли диск X в качестве имени диска Windows PowerShell.
В противном случае команда использует New-PSDrive
командлет для создания временного диска, сопоставленного с разделом реестра HKLM:\SOFTWARE.
Пример 5. Сравнение типов дисков файловой системы
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
В этом примере сравниваются типы дисков файловой системы, отображаемые Get-PSDrive
с помощью других методов. В этом примере демонстрируются различные способы отображения дисков в Windows PowerShell, а также показано, что диски для конкретного сеанса, созданные с помощью командлета New-PSDrive, доступны только в Windows PowerShell.
Первая команда использует Get-PSDrive
для получения всех дисков файловой системы в сеансе. Сюда входят фиксированные диски (C: и D:), сопоставленный сетевой диск (G:), созданный с помощью параметра New-PSDrive
Persist , и диск PowerShell (T:), созданный с помощью New-PSDrive
без параметра Persist.
Команда net use отображает подключенные сетевые диски Windows. В этом случае отображается только диск G. В нем не отображается диск X:, созданный .New-PSDrive
Он показывает, что диск G: также сопоставлен с \\Music\GratefulDead.
Третья команда использует метод GetDrives класса System.IO.DriveInfo Microsoft .NET Framework. Эта команда получает диски файловой системы Windows, включая диск G:, но не получает диски, созданные .New-PSDrive
Четвертая команда использует Get-CimInstance
командлет для получения экземпляров класса Win32_LogicalDisk . Он возвращает диски A:, C:, D:, E:и G:, но не диски, созданные .New-PSDrive
Последняя команда использует Get-CimInstance
командлет для отображения экземпляров класса Win32_NetworkConnection . Как и net use, он возвращает только постоянный диск G:, созданный New-PSDrive
.
Параметры
-LiteralName
Задает имя диска.
Значение параметра LiteralName используется точно так, как вводится. Никакие символы не интерпретируются как знаки подстановки. Если имя включает escape-символы, заключите их в одинарные кавычки. Это позволит Windows PowerShell не интерпретировать какие-либо символы как символы Escape-последовательности.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Указывает в виде массива строк имя или имя дисков, которые этот командлет получает в операции.
Введите имя или букву диска без двоеточия (:
).
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PSProvider
Указывает в качестве массива строк поставщик Windows PowerShell. Этот командлет получает только диски, поддерживаемые этим поставщиком. Введите имя поставщика, например FileSystem, Registry или Certificate.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Scope
Указывает область, в котором этот командлет получает диски.
Допустимые значения для этого параметра:
- Глобальный
- Local
- Скрипт
- число относительно текущего область (от 0 до числа областей, где 0 — это текущее область, а 1 — родительский). По умолчанию используется значение Local.
Дополнительные сведения см. в разделе about_Scopes.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Входные данные
None
Вы не можете передавать объекты в этот командлет.
Выходные данные
Этот командлет возвращает объекты, представляющие диски в сеансе.
Примечания
PowerShell включает следующие псевдонимы для Get-PSDrive
:
Для всех платформ.
gdr
Этот командлет предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы получить список поставщиков, доступных в сеансе
Get-PSProvider
, используйте командлет . Дополнительные сведения см. в разделе about_Providers.Сопоставленные сетевые диски, созданные с помощью параметра Persist командлета New-PSDrive, относятся к учетной записи пользователя. Сопоставленные сетевые диски, создаваемые в сеансах, запущенных с помощью параметра Запуск от имени администратора или с учетными данными другого пользователя, не отображаются в сеансах, запущенных без явных учетных данных или с учетными данными текущего пользователя.