Obtém as unidades do Windows PowerShell na sessão atual.

Sintaxe

Get-PSDrive [-LiteralName] <string[]> [-PSProvider <string[]>] [-Scope <string>] [-UseTransaction] [<CommonParameters>]

Get-PSDrive [[-Name] <string[]>] [-PSProvider <string[]>] [-Scope <string>] [-UseTransaction] [<CommonParameters>]

Descrição

O cmdlet Get-PSDrive obtém as unidades do Windows PowerShell na sessão atual. Você pode obter uma unidade específica ou todas as unidades no console.

Get-PSDrive obtém as seguintes unidades:

-- Unidades lógicas do Windows no computador, incluindo as unidades mapeadas para compartilhamentos de rede.

-- Unidades expostas pelos provedores do Windows PowerShell (como as unidades Certificate:, Function:, e Alias:) e as unidades HKLM: e HKCU: expostas pelo provedor Registry do Windows PowerShell.

-- Unidades que você cria usando New-PSDrive.

Get-PSDrive não obtém as unidades mapeadas do Windows adicionadas ou criadas depois que o console do Windows PowerShell é aberto.

Parâmetros

-LiteralName <string[]>

Especifica o nome da unidade do Windows PowerShell a ser removida.

O valor de LiteralName é usado exatamente como é digitado. Nenhum caractere será interpretado como curinga. Se o nome incluir caracteres de escape, coloque-os entre aspas simples. As aspas simples dizem ao Windows PowerShell para não interpretar quaisquer caracteres que tenham sequências de escape.

Necessário?

true

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-Name <string[]>

Obtém apenas as unidades especificadas. Digite o nome ou a letra da unidade sem dois-pontos (:).

Necessário?

false

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-PSProvider <string[]>

Obtém apenas as unidades suportadas pelo provedor do Windows PowerShell especificado. Digite o nome de um provedor, como FileSystem, Registry ou Certificate.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-Scope <string>

Obtém apenas as unidades do Windows PowerShell no escopo especificado. Os valores válidos são "Global", "Local" ou "Script" ou um número relativo ao atual escopo (0 ao número de escopos, onde 0 é o escopo atual e 1 é seu pai). "Local" é o padrão. Para obter mais informações, consulte about_Scopes.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-UseTransaction

Inclui o comando na transação ativa. Este parâmetro é válido apenas quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

None

Não é possível enviar objetos para Get-PSDrive.

Saídas

System.Management.Automation.PSDriveInfo

Get-PSDrive retorna objetos que representam as unidades do Windows PowerShell na sessão.

Observações

O cmdlet Get-PSDrive foi desenvolvido para funcionar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite "Get-PSProvider". Para obter mais informações, consulte about_Providers.

Exemplo 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:\

Descrição
-----------
Esse comando obtém as unidades do Windows PowerShell na sessão atual. 

A saída mostra o disco rígido (C:) e a unidade de CD-ROM (D:) no computador, as unidades expostas pelos provedores do Windows PowerShell (Alias:, Cert:, Env:, Function:, HKCU:, HKLM: e Variable:) e uma unidade mapeada para um compartilhamento de rede (X:).






Exemplo 2

C:\PS>get-psdrive d

Name       Provider      Root
----       --------      ----
D          FileSystem    D:\

Descrição
-----------
Esse comando exibe a unidade D: no computador. Observe que a letra da unidade não é seguida por dois-pontos.






Exemplo 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

Descrição
-----------
Esse comando exibe todas as unidades suportadas pelo provedor FileSystem do Windows PowerShell. Isso inclui unidades fixas, partições lógicas, unidades de rede mapeadas e unidades criadas com New-PSDrive mapeadas para as unidades do sistema de arquivos.

Este exemplo mostra que as unidades criadas por New-PSDrive têm o nome do local mapeado no valor da propriedade Root. As unidades do Windows apenas têm a raiz da letra da unidade.






Exemplo 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." }

Descrição
-----------
Esse comando verifica se a unidade X já está em uso com o nome de unidade do Windows PowerShell. Se não estiver, o comando usará o cmdlet New-PSDrive para criar uma unidade do Windows PowerShell mapeada para a chave do Registro HKLM:\Network.






Exemplo 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

Descrição
-----------
Este exemplo compara os tipos de unidades do sistema de arquivos exibidas por Get-PSDrive com aqueles exibidos por outros métodos. Este exemplo demonstra modos diferentes de exibir unidades no Windows PowerShell e mostra que as unidades criadas com New-PSDrive são acessíveis apenas no Windows PowerShell.

O primeiro comando usa Get-PSDrive para obter todas as unidades do sistema de arquivos no console do Windows PowerShell. Isso inclui as unidades fixas (C: e D:), a unidade de rede mapeada (X:) e duas unidades do Windows PowerShell (Y: e Z:) criadas usando New-PsDrive.

Um comando “net use”, que exibe as unidades de rede mapeadas do Windows, exibe apenas a unidade X. Ele não exibe unidades criadas por New-PSDrive. Ele mostra que a unidade X: também é mapeada para \\Server01\Public.

O terceiro comando usa o método GetDrives da classe System.IO.DriveInfo do Microsoft .NET Framework. Esse comando obtém as unidades do sistema de arquivos do Windows, inclusive a unidade X:, mas não obtém as unidades criadas por New-PSDrive.

O quarto comando usa o cmdlet Get-WmiObject para exibir as instâncias da classe Win32_LogicalDisk. Ele retorna as unidades C:, D: e X:, mas não as unidades criadas por New-PSDrive.

O último comando usa o cmdlet Get-WmiObject para exibir as instâncias da classe Win32_NetworkConnection. Como “net use”, ele retorna apenas a unidade X:.






See Also




Sumário