Spostarsi all'interno dei percorsi di SQL Server PowerShellNavigate SQL Server PowerShell Paths

Il provider Motore di databaseDatabase Engine PowerShell espone il set di oggetti in un'istanza di SQL Server in una struttura analoga a un percorso di file.The Motore di databaseDatabase Engine PowerShell provider exposes the set of objects in an instance of SQL Server in a structure similar to a file path. È 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.You can use Windows PowerShell cmdlets to navigate the provider path, and create custom drives to shorten the path you have to type.

Prima di iniziareBefore You Begin

Windows PowerShell implementa cmdlet per spostarsi all'interno della struttura del percorso che rappresenta la gerarchia di oggetti supportati da un provider PowerShell.Windows PowerShell implements cmdlets to navigate the path structure that represent the hierarchy of objects supported by a PowerShell provider. Quando si passa a un nodo nel percorso, è possibile utilizzare altri cmdlet per eseguire operazioni di base sull'oggetto corrente.When you have navigated to a node in the path, you can use other cmdlets to perform basic operations on the current object. Poiché vengono utilizzati frequentemente, i cmdlet dispongono di alias brevi e canonici.Because the cmdlets are used frequently, they have short, canonical aliases. È 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.There is also one set of aliases that maps the cmdlets to similar command prompt commands, and another set for UNIX shell commands.

Il provider SQL ServerSQL Server implementa un subset di cmdlet del provider, illustrato nella tabella seguente.The SQL ServerSQL Server provider implements a subset of the provider cmdlets, shown in the following table.

cmdletcmdlet Alias canonicoCanonical alias Alias cmdcmd alias Alias di shell di UNIXUNIX shell alias DescrizioneDescription
Get-LocationGet-Location glgl pwdpwd pwdpwd Consente di ottenere il nodo corrente.Gets the current node.
Set-LocationSet-Location slsl cd, chdircd, chdir cd, chdircd, chdir Consente di modificare il nodo corrente.Changes the current node.
Get-ChildItemGet-ChildItem gcigci dirdir lsls Consente di visualizzare un elenco degli oggetti archiviati nel nodo corrente.Lists the objects stored at the current node.
Get-ItemGet-Item gigi Restituisce le proprietà dell'elemento corrente.Returns the properties of the current item.
Rename-ItemRename-Item rnirni rnrn renren Consente di rinominare un oggetto.Renames an object.
Remove-ItemRemove-Item riri del, rddel, rd rm, rmdirrm, rmdir Consente di rimuovere un oggetto.Removes an object.

Importante

Alcuni identificatori (nomi di oggetto) di SQL ServerSQL Server contengono caratteri non supportati da Windows PowerShell nei nomi dei percorsi.Some SQL ServerSQL Server identifiers (object names) contain characters that Windows PowerShell does not support in path names. Per altre informazioni sull'uso dei nomi che contengono questi caratteri, vedere Identificatori di SQL Server in PowerShell.For more information about how to use names that contain these characters, see SQL Server Identifiers in PowerShell.

Informazioni su SQL Server restituite da Get-ChildItemSQL Server Information Returned by Get-ChildItem

Le informazioni restituite da Get-ChildItem (o dai relativi alias dir e ls ) dipendono dalla posizione in un percorso SQLSERVER.The information returned by Get-ChildItem (or its dir and ls aliases) depends on your location in a SQLSERVER: path.

Posizione nel percorsoPath location Risultati di Get-ChildItemGet-ChildItem results
SQLSERVER:\SQLSQLSERVER:\SQL Restituisce il nome del computer locale.Returns the name of the local computer. Se è stato utilizzato SMO o WMI per connettersi a istanze del Motore di databaseDatabase Engine in altri computer, vengono elencati anche tali computer.If you have used the SMO or WMI to connect to instances of the Motore di databaseDatabase Engine on other computers, those computers are also listed.
SQLSERVER:\SQL\NomeComputerSQLSERVER:\SQL\ComputerName Elenco delle istanze di Motore di databaseDatabase Engine nel computer.The list of instances of the Motore di databaseDatabase Engine on the computer.
SQLSERVER:\SQL\NomeComputer\NomeIstanzaSQLSERVER:\SQL\ComputerName\InstanceName Elenco dei tipi di oggetto di primo livello nell'istanza, ad esempio Endpoint, Certificati e Database.The list of top-level object types in the instance, such as Endpoints, Certificates, and Databases.
Nodo della classe di oggetto, ad esempio DatabaseObject class node, such as Databases Elenco di oggetti del tipo, ad esempio l'elenco di database: master, model, AdventureWorks2008R2.The list of objects of that type, such as the list of databases: master, model, AdventureWorks20008R2.
Nodo del nome dell'oggetto, ad esempio AdventureWorks2012Object name node, such as AdventureWorks2012 Elenco dei tipi di oggetto contenuti all'interno dell'oggetto.The list of object types contained within the object. Per un database, ad esempio, vengono elencati tipi di oggetto come tabelle e viste.For example, a database would list object types such as tables and views.

Per impostazione predefinita, Get-ChildItem non elenca oggetti di sistema.By default, Get-ChildItem does not list any system objects. Usare il parametro Force per visualizzare gli oggetti di sistema, ad esempio gli oggetti nello schema sys .Use the Force parameter to see system objects, such as the objects in the sys schema.

Unità personalizzateCustom Drives

Windows PowerShell consente agli utenti di definire unità virtuali, definite come unità di PowerShell.Windows PowerShell lets users define virtual drives, which are referred to as PowerShell drives. Per tali unità viene eseguito il mapping ai nodi iniziali di un'istruzione di percorso.These map over the starting nodes of a path statement. Tali unità vengono in genere utilizzate per abbreviare percorsi digitati con frequenza.They are typically used to shorten paths that are typed frequently. I percorsi SQLSERVER: possono diventare lunghi, occupando spazio nella finestra di Windows PowerShell e richiedendo molta digitazione.SQLSERVER: paths can get long, taking space in the Windows PowerShell window and requiring a lot of typing. 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.If you are going to do a lot of work at a particular path node, you can define a custom Windows PowerShell drive that maps to that node.

Utilizzare alias di cmdlet di PowerShellUse PowerShell Cmdlet Aliases

Utilizzare un alias di cmdletUse a cmdlet alias

  • 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.Instead of typing a full cmdlet name, type a shorter alias, or one that maps to a familiar commend prompt command.

Esempio di alias (PowerShell)Alias Example (PowerShell)

È ad esempio possibile utilizzare uno dei set di cmdlet o alias seguenti per recuperare un elenco delle istanze di SQL ServerSQL Server disponibili passando alla cartella SQLSERVER:\SQL e richiedendo l'elenco di elementi figlio per la cartella:For example, you can use one of the following sets of cmdlets or aliases to retrieve a listing of the SQL ServerSQL Server instances available to you by navigating to the SQLSERVER:\SQL folder and requesting the list of child items for the folder:

## 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-ChildItemUse Get-ChildItem

Restituire informazioni utilizzando Get-ChildItemReturn information by using Get-Childitem

  1. Passare al nodo per il quale si desidera un elenco di childremNavigate to the node for which you want a list of childrem

  2. Eseguire Get-ChildItem per ottenere l'elenco.Run Get-Childitem to get the list.

Esempio di Get-ChildItem (PowerShell)Get-ChildItem Example (PowerShell)

In questi esempi sono illustrate le informazioni restituite da Get-ChildItem per i nodi diversi in un percorso del provider SQL Server.These examples illustrate the information returned by Get-Childitem for different nodes in a SQL Server provider path.

## 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à personalizzataCreate a Custom Drive

Creare e utilizzare un'unità personalizzataCreate and use a custom drive

  1. Usare New-PSDrive per definire un'unità personalizzata.Use New-PSDrive to define a custom drive. Usare il parametro Root per specificare il percorso rappresentato dal nome di unità personalizzato.Use the Root parameter to specify the path that is represented by the custom drive name.

  2. Fare riferimento al nome di unità personalizzata nei cmdlet di navigazione come Set-Location.Reference the custom drive name in path navigation cmdlets such as Set-Location.

Esempio di unità personalizzata (PowerShell)Custom Drive Example (PowerShell)

Questo esempio crea un'unità virtuale denominata AWDB con mapping al nodo di una copia distribuita del database di esempio di AdventureWorks2012.This example creates a virtual drive named AWDB that maps to the node for a deployed copy of the AdventureWorks2012 sample database. L'unità virtuale è utilizzata quindi per passare a una tabella nel database.The virtual drive is then used to navigate to a table in the database.

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

Vedere ancheSee Also

Provider PowerShell per SQL Server SQL Server PowerShell Provider
Utilizzo di percorsi di SQL Server PowerShell Work With SQL Server PowerShell Paths
Conversione di URN in percorsi di provider di SQL Server Convert URNs to SQL Server Provider Paths
SQL Server PowerShellSQL Server PowerShell