Navegar em caminhos do SQL Server PowerShell

Artigo
06/25/2013

O provedor do Mecanismo de Banco de Dados PowerShell expõe o conjunto de objetos em uma instância do SQL Server em uma estrutura semelhante a um caminho de arquivo. Você pode usar cmdlets do Windows PowerShell para navegar até o caminho do provedor e criar unidades personalizadas para encurtar o caminho que você tem que digitar.

Antes de começar

O Windows PowerShell implementa cmdlets para navegar na estrutura do caminho que representa a hierarquia de objetos por um provedor do PowerShell. Ao navegar até um nó do caminho, você pode usar outros cmdlets para executar operações básicas no objeto atual. Como os cmdlets são usados com frequência, eles têm aliases pequenos e canônicos. Também existe um conjunto de aliases que mapeia os cmdlets para comandos semelhantes do prompt de comando e outro conjunto para comandos shell do UNIX.

O provedor do SQL Server implementa um subconjunto de cmdlets do provedor, mostrados na tabela a seguir:

cmdlet	Alias canônico	Alias de cmd	Alias de shell do UNIX	Descrição
Get-Location	gl	pwd	pwd	Obtém o nó atual.
Set-Location	sl	cd, chdir	cd, chdir	Altera o nó atual.
Get-ChildItem	gci	dir	ls	Lista os objetos armazenados no nó atual.
Get-Item	gi			Retorna as propriedades do item atual.
Rename-Item	rni	rn	ren	Renomeia um objeto.
Remove-Item	ri	del, rd	rm, rmdir	Remove um objeto.

Importante
Alguns identificadores do SQL Server (nomes de objeto) contêm caracteres não suportados pelos nomes de caminho do Windows PowerShell. Para obter mais informações sobre como usar os nomes que contêm esses caracteres, consulte Identificadores do SQL Server no PowerShell.

Informações do SQL Server retornadas por Get-ChildItem

A informações retornadas por Get-ChildItem (ou seus aliases dir e ls) dependem de seu local em um caminho SQLSERVER:.

Local do caminho	Resultados de Get-ChildItem
SQLSERVER:\SQL	Retorna o nome do computador local. Se você usou o SMO ou o WMI para se conectar às instâncias do Mecanismo de Banco de Dados em outros computadores, esses computadores também estarão listados.
SQLSERVER:\SQL\ComputerName	A lista de instâncias do Mecanismo de Banco de Dados no computador.
SQLSERVER:\SQL\ComputerName\InstanceName	A lista de tipos de objeto de nível superior na instância, como Pontos de Extremidade, Certificados e Bancos de Dados.
Nó da classe de objeto, como Bancos de Dados	A lista de objetos desse tipo, como a lista de bancos de dados: master, model, AdventureWorks20008R2.
O nó do nome de objeto, como AdventureWorks2012	A lista de tipos de objeto contida no objeto. Por exemplo, um banco de dados poderia listar tipos de objeto, como tabelas e exibições.

Por padrão, Get-ChildItem não lista nenhum objeto de sistema. Use o parâmetro Force para ver objetos de sistema, como os objetos no esquema sys.

Unidades personalizadas

O Windows PowerShell permite que os usuários definam unidades virtuais que são conhecidas como unidades PowerShell. Elas mapeiam os nós iniciais de uma instrução de caminho. Em geral, elas são usadas para encurtar caminhos que são digitados com frequência. SQLSERVER: os caminhos podem se tornar longos, ocupando muito espaço na janela do Windows PowerShell e exigindo muita digitação. Se você vai trabalhar muito em um nó de caminho específico, é possível definir uma unidade personalizada do Windows PowerShell mapeada para esse nó.

Usar aliases de cmdlet do PowerShell

Usar um alias de cmdlet

Em vez de digitar um nome de cmdlet completo, digite um alias mais curto ou um que mapeia para um prompt de comando familiar.

Exemplo de alias (PowerShell)

Por exemplo, você pode usar um dos conjuntos de cmdlets ou aliases a seguir para recuperar uma listagem das instâncias do SQL Server disponíveis navegando para a pasta SQLSERVER:\SQL e solicitando a lista de itens filho da pasta:

## Shows using the full cmdet name.
Set-Location SQLSERVER:\SQL
Get-ChildItem

## Shows using canonical aliases.
sl SQLSERVER:\SQL
gci

## Shows using command prompt aliases.
cd SQLSERVER:\SQL
dir

## Shows using Unix shell aliases.
cd SQLSERVER:\SQL
ls

Usar Get-ChildItem

Retornar informações usando Get-Childitem

Navegue até o nó para o qual você deseja uma lista de childrem
Execute Get-Childitem para obter a lista.

Exemplo de Get-ChildItem (PowerShell)

Estes exemplos ilustram as informações retornadas por Get-Childitem para nós diferentes em um caminho de provedor do SQL Server.

## Return the current computer and any computer
## to which you have made a SQL or WMI connection.
Set-Location SQLSERVER:\SQL
Get-ChildItem

## List the instances of the Database Engine on the local computer.

Set-Location SQLSERVER:\SQL\localhost
Get-ChildItem

## Lists the categories of objects available in the
## default instance on the local computer.
Set-Location SQLSERVER:\SQL\localhost\DEFAULT
Get-ChildItem

## Lists the databases from the local default instance.
## The force parameter is used to include the system databases.
Set-Location SQLSERVER:\SQL\localhost\DEFAULT\Databases
Get-ChildItem -force

Criar uma unidade personalizada

Criar e usar uma unidade personalizada

Use New-PSDrive para definir uma unidade personalizada. Use o parâmetro Root para especificar o caminho que é representado pelo nome de unidade personalizada.
Referencie o nome de unidade personalizada em cmdlets de navegação do caminho como Set-Location.

Exemplo de unidade personalizada (PowerShell)

Este exemplo cria uma unidade virtual chamada AWDB que mapeia para o nó de uma cópia implantada do banco de dados de exemplo AdventureWorks2012. A unidade virtual é usada para navegar até uma tabela no banco de dados.

## Create a new virtual drive.
New-PSDrive -Name AWDB -Root SQLSERVER:\SQL\localhost\DEFAULT\Databases\AdventureWorks2012

## Use AWDB: to navigate to a specific table.
Set-Location AWDB:\Tables\Purchasing.Vendor