Spostarsi all'interno dei percorsi di SQL Server PowerShell

Articolo
05/23/2023

Si applica a:SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW)

Il provider PowerShell del motore di database espone il set di oggetti in un'istanza di SQL Server in una struttura analoga a un percorso di file. È possibile utilizzare cmdlet di Windows PowerShell per spostarsi all'interno del percorso del provider e creare unità personalizzate per rendere più breve il percorso da digitare.

Nota

Esistono due moduli SQL Server PowerShell: SqlServer e SQLPS.

SqlServer è il modulo corrente di PowerShell da usare.

SQLPS è incluso nell'installazione di SQL Server (per compatibilità con le versioni precedenti), ma non viene più aggiornato.

Il modulo SqlServer contiene le versioni aggiornate dei cmdlet di SQLPS e include nuovi cmdlet per il supporto delle funzionalità SQL più recenti.

Installare il modulo SqlServer da PowerShell Gallery.

Per altre informazioni, vedere SQL Server PowerShell.

Windows PowerShell implementa cmdlet per spostarsi all'interno della struttura del percorso che rappresenta la gerarchia di oggetti supportati da un provider PowerShell. Quando si passa a un nodo nel percorso, è possibile utilizzare altri cmdlet per eseguire operazioni di base sull'oggetto corrente. Poiché vengono utilizzati frequentemente, i cmdlet dispongono di alias brevi e canonici. È inoltre presente un set di alias che esegue il mapping dei cmdlet a comandi simili del prompt dei comandi e un altro set per i comandi della shell di UNIX.

Il provider SQL Server implementa un subset di cmdlet del provider, illustrato nella tabella seguente:

Cmdlet	Alias canonico	Alias cmd	Alias di shell di UNIX	Descrizione
Get-Location	gl	pwd	pwd	Consente di ottenere il nodo corrente.
Set-Location	sl	cd, chdir	cd, chdir	Consente di modificare il nodo corrente.
Get-ChildItem	gci	dir	ls	Consente di visualizzare un elenco degli oggetti archiviati nel nodo corrente.
Get-Item	gi			Restituisce le proprietà dell'elemento corrente.
Rename-Item	rni	rn	ren	Consente di rinominare un oggetto.
Remove-Item	ri	del, rd	rm, rmdir	Consente di rimuovere un oggetto.

Importante

Alcuni identificatori (nomi di oggetto) di SQL Server contengono caratteri non supportati da Windows PowerShell nei nomi dei percorsi. Per altre informazioni sull'uso dei nomi che contengono questi caratteri, vedere Identificatori di SQL Server in PowerShell.

Informazioni su SQL Server restituite da Get-ChildItem

Le informazioni restituite da Get-ChildItem (o dai relativi alias dir e ls ) dipendono dalla posizione in un percorso SQLSERVER.

Posizione nel percorso	Risultati di Get-ChildItem
SQLSERVER:\SQL	Restituisce il nome del computer locale. Se per la connessione a istanze del motore di database in altri computer è stato usato SMO o WMI, vengono elencati anche tali computer.
SQLSERVER:\SQL\ComputerName	Elenco di istanze del motore di database nel computer.
SQLSERVER:\SQL\ComputerName\InstanceName	Elenco dei tipi di oggetto di primo livello nell'istanza, ad esempio Endpoint, Certificati e Database.
Nodo della classe di oggetto, ad esempio Database	Elenco di oggetti del tipo, ad esempio l'elenco di database: `master`, `model`, `AdventureWorks2022`.
Nodo del nome dell'oggetto, ad esempio `AdventureWorks2022`	Elenco dei tipi di oggetto contenuti all'interno dell'oggetto. Per un database, ad esempio, vengono elencati tipi di oggetto come tabelle e viste.

Per impostazione predefinita, Get-ChildItem non elenca oggetti di sistema. Usare il parametro Force per visualizzare gli oggetti di sistema, ad esempio gli oggetti nello schema sys .

Unità personalizzate

Windows PowerShell consente agli utenti di definire unità virtuali, definite come unità di PowerShell. Per tali unità viene eseguito il mapping ai nodi iniziali di un'istruzione di percorso. Tali unità vengono in genere utilizzate per abbreviare percorsi digitati con frequenza. I percorsi SQLSERVER: possono diventare lunghi, occupando spazio nella finestra di Windows PowerShell e richiedendo molta digitazione. Se si prevede di lavorare molto in un particolare nodo del percorso, è possibile definire un'unità di Windows PowerShell personalizzata di cui è stato eseguito il mapping a tale nodo.

Utilizzare alias di cmdlet di PowerShell

Utilizzare un alias di cmdlet

Anziché digitare il nome completo di un cmdlet, digitare un alias più breve o uno con mapping a un comando comune del prompt dei comandi.

Esempio di alias (PowerShell)

È ad esempio possibile utilizzare uno dei set di cmdlet o alias seguenti per recuperare un elenco delle istanze di SQL Server disponibili passando alla cartella SQLSERVER:\SQL e richiedendo l'elenco di elementi figlio per la cartella:

## 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

Utilizzare Get-ChildItem

Restituire informazioni utilizzando Get-ChildItem

Passare al nodo per il quale si vuole ottenere un elenco di elementi figlio
Eseguire Get-ChildItem per ottenere l'elenco.

Esempio di Get-ChildItem (PowerShell)

In questi esempi sono illustrate le informazioni restituite da Get-ChildItem per i nodi diversi in un percorso del provider 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

Creare un'unità personalizzata

Creare e utilizzare un'unità personalizzata

Usare New-PSDrive per definire un'unità personalizzata. Usare il parametro Root per specificare il percorso rappresentato dal nome di unità personalizzato.
Fare riferimento al nome di unità personalizzata nei cmdlet di navigazione come Set-Location.

Esempio di unità personalizzata (PowerShell)

Questo esempio crea un'unità virtuale denominata AWDB con mapping al nodo di una copia distribuita del database di esempio di AdventureWorks2022. L'unità virtuale è utilizzata quindi per passare a una tabella nel database.

## Create a new virtual drive.  
New-PSDrive -Name AWDB -Root SQLSERVER:\SQL\localhost\DEFAULT\Databases\AdventureWorks2022  
  
## Use AWDB: to navigate to a specific table.  
Set-Location AWDB:\Tables\Purchasing.Vendor