Obtiene las unidades de Windows PowerShell incluidas en la sesión actual.
Sintaxis
Get-PSDrive [-LiteralName] <string[]> [-PSProvider <string[]>] [-Scope <string>] [-UseTransaction] [<CommonParameters>] Get-PSDrive [[-Name] <string[]>] [-PSProvider <string[]>] [-Scope <string>] [-UseTransaction] [<CommonParameters>]
Descripción
El cmdlet Get-PSDrive obtiene las unidades de Windows PowerShell incluidas en la sesión actual. Puede obtener una unidad concreta o todas las unidades incluidas en la consola.
Get-PSDrive obtiene las unidades siguientes:
-- Unidades lógicas de Windows en el equipo, incluidas las unidades asignadas a recursos compartidos de red.
-- Unidades expuestas por proveedores de Windows PowerShell (como las unidades Certificate:, Function: y Alias:) y las unidades HKLM: y HKCU: expuestas por el proveedor Registry de Windows PowerShell.
-- Unidades creadas utilizando New-PSDrive.
Get-PSDrive no obtiene unidades asignadas de Windows que se han agregado o creado después de abrirse la consola de Windows PowerShell.
Parámetros
-LiteralName <string[]>
Especifica el nombre de la unidad de Windows PowerShell.
El valor de LiteralName se usa literalmente como se escribe. Ningún carácter se interpretará como un carácter comodín. Si el nombre incluye caracteres de escape, debe escribirlo entre comillas simples. Las comillas simples indican a Windows PowerShell que no debe interpretar los caracteres como secuencias de escape.
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Name <string[]>
Obtiene solamente las unidades especificadas. Escriba el nombre o la letra de la unidad sin signo de dos puntos (:).
|
¿Requerido? |
false |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-PSProvider <string[]>
Obtiene solamente las unidades admitidas por el proveedor de Windows PowerShell especificado. Escriba el nombre de un proveedor, como FileSystem, Registry o Certificate.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-Scope <string>
Obtiene solamente las unidades de Windows PowerShell en el ámbito especificado. Los valores válidos son "Global", "Local", "Script" o el número correspondiente al ámbito actual (entre 0 y el número de ámbitos, donde 0 es el ámbito actual y 1 su ámbito principal). "Local" es el valor predeterminado. Para obtener más información, vea about_Scopes.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
true (ByPropertyName) |
|
¿Aceptar caracteres comodín? |
false |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro sólo es válido cuando hay una transacción en curso. Para obtener más información, vea about_Transactions.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
Ninguno No se pueden canalizar objetos a Get-PSDrive. |
|
Salidas |
System.Management.Automation.PSDriveInfo Get-PSDrive devuelve objetos que representan las unidades de Windows PowerShell en la sesión. |
Notas
El cmdlet Get-PSDrive está diseñado para funcionar con los datos expuestos por cualquier proveedor. Para mostrar los proveedores que están disponibles en la sesión, escriba "Get-PSProvider". Para obtener más información, vea about_Providers.
Ejemplo 1
C:\PS>get-psdrive Name Provider Root ---- -------- ---- Alias Alias C FileSystem C:\ cert Certificate \ D FileSystem D:\ Env Environment Function Function HKCU Registry HKEY_CURRENT_USER HKLM Registry HKEY_LOCAL_MACHINE Variable Variable X FileSystem X:\ Descripción ----------- Este comando obtiene las unidades de Windows PowerShell incluidas en la sesión actual. Los resultados muestran la unidad de disco duro (C:) y la unidad de CD-ROM (D:) en el equipo, las unidades expuestas por los proveedores de Windows PowerShell (Alias:, Cert:, Env:, Function:, HKCU:, HKLM: y Variable:), y una unidad asignada a un recurso compartido de red (X:).
Ejemplo 2
C:\PS>get-psdrive d Name Provider Root ---- -------- ---- D FileSystem D:\ Descripción ----------- Este comando muestra la unidad D: en el equipo. Observe que la letra de unidad no va seguida de un signo de dos puntos.
Ejemplo 3
C:\PS>get-psdrive -psprovider filesystem Name Provider Root ---- -------- ---- C FileSystem C:\ D FileSystem D:\ X FileSystem X:\ Y FileSystem \\Server01\Public Z FileSystem C:\Windows\System32 Descripción ----------- Este comando muestra todas las unidades admitidas por el proveedor FileSystem de Windows PowerShell. Entre ellas se incluyen unidades fijas, particiones lógicas, unidades de red asignadas y unidades que se crean utilizando New-PSDrive asignadas a las unidades del sistema de archivos. En este ejemplo se muestra que las unidades creadas por New-PSDrive tienen el nombre de la ubicación asignada en el valor de la propiedad Root. Las unidades de Windows tienen solamente la raíz de la letra de unidad.
Ejemplo 4
C:\PS>if (!(get-psdrive X)) {
new-psdrive -name X -psprovider Registry -root HKLM:\Network
}
else { write-host "The X: drive is already in use." }
Descripción
-----------
Este comando comprueba si la unidad X ya se está usando como nombre de unidad de Windows PowerShell. Si no es así, el comando utiliza el cmdlet New-PSDrive para crear una unidad de Windows PowerShell que se asigna a la clave del Registro HKLM:\Network.
Ejemplo 5
C:\PS>get-psdrive -provider filesystem
C:\PS> get-psdrive -provider filesystem
Name Provider Root
---- -------- ----
C FileSystem C:\
D FileSystem D:\
X FileSystem X:\
Y FileSystem \\Server01\Public
Z FileSystem C:\Windows\System32
C:\PS> net use
New connections will be remembered.
Status Local Remote Network
-------------------------------------------------------------------------------
X: \\Server01\Public Microsoft Windows Network
C:\PS> [System.IO.DriveInfo]::getdrives()
Name : C:\
DriveType : Fixed
DriveFormat : NTFS
IsReady : True
AvailableFreeSpace : 39831498752
TotalFreeSpace : 39831498752
TotalSize : 79900368896
RootDirectory : C:\
VolumeLabel :
Name : D:\
DriveType : CDRom
DriveFormat :
IsReady : False
AvailableFreeSpace :
TotalFreeSpace :
TotalSize :
RootDirectory : D:\
VolumeLabel :
Name : X:\
DriveType : Network
DriveFormat : NTFS
IsReady : True
AvailableFreeSpace : 36340559872
TotalFreeSpace : 36340559872
TotalSize : 36413280256
RootDirectory : X:\
VolumeLabel : D_Drive
C:\PS> get-wmiobject win32_logicaldisk
DeviceID : C:
DriveType : 3
ProviderName :
FreeSpace : 39831252992
Size : 79900368896
VolumeName :
DeviceID : D:
DriveType : 5
ProviderName :
FreeSpace :
Size :
VolumeName :
DeviceID : X:
DriveType : 4
ProviderName : \\server01\public
FreeSpace : 36340559872
Size : 36413280256
VolumeName : D_Drive
C:\PS> get-wmiobject win32_networkconnection
LocalName RemoteName
-------------- ------------
x: \\server01\public
Descripción
-----------
En este ejemplo se comparan los tipos de las unidades del sistema mostradas por Get-PSDrive con las mostradas utilizando otros métodos. En este ejemplo se demuestran distintas maneras de mostrar unidades en Windows PowerShell y se muestra que las unidades creadas utilizando New-PSDrive solo son accesibles en Windows PowerShell.
El primer comando utiliza Get-PSDrive para obtener todas las unidades del sistema de archivos incluidas en la consola de Windows PowerShell. Entre ellas se incluyen las unidades fijas (C: y D:), la unidad de red asignada (X:) y dos unidades de Windows PowerShell (Y: y Z:) que se crearon utilizando New-PsDrive.
Un comando "net use", que muestra las unidades de red asignadas de Windows, muestra sólo la unidad X. No muestra las unidades creadas mediante New-PSDrive. Muestra que la unidad X: también se asigna a \\Server01\Public.
El tercer comando usa el método GetDrives de la clase System.IO.DriveInfo de Microsoft .NET Framework. Este comando obtiene las unidades del sistema de archivos de Windows, incluida la unidad X:, pero no obtiene las unidades creadas mediante New-PSDrive.
El cuarto comando utiliza el cmdlet Get-WmiObject para mostrar las instancias de la clase Win32_LogicalDisk. Devuelve las unidades C:, D: y X:, pero no las unidades creadas mediante New-PSDrive.
El último comando utiliza el cmdlet Get-WmiObject para mostrar las instancias de la clase Win32_NetworkConnection. Al igual que en el caso de "net use", solamente devuelve la unidad X:.
Vea también