Visualizzazione della Guida di SQL Server PowerShell
Vi sono diverse fonti di informazione per l'utilizzo dei cmdlet e del provider di SQL Server per Windows PowerShell. Tra queste è inclusa la Guida disponibile nell'ambiente di Windows PowerShell.
Prima di iniziare
Per informazioni su Windows PowerShell, vedere la Guida introduttiva a Windows PowerShell.
Per una panoramica dei cmdlet e del provider di SQL Server, vedere SQL Server PowerShell.
Guida all'ambiente di Windows PowerShell
Utilizzare il cmdlet Get-Help per informazioni sull'ambiente di Windows PowerShell. Get-Help fornisce informazioni di base sul linguaggio di Windows PowerShell e sui vari cmdlet e provider disponibili in Windows PowerShell.
Per ulteriori informazioni sulle modalità di utilizzo di Get-Help, vedere Visualizzazione della guida: Get-Help.
Guida del provider PowerShell per SQL Server
Il provider PowerShell di SQL Server implementa diverse cartelle su un'unità virtuale SQLSERVER, come ad esempio le cartelle SQLSERVER:\SQL e SQLSERVER:\DAC. Ogni cartella è associata a uno dei modelli a oggetti per la gestione di SQL Server. È possibile elencare i metodi e le proprietà associati a ogni nodo in un percorso di SQL Server, ma non è possibile ottenerne la guida nell'ambiente PowerShell. Per una tabella delle cartelle con i collegamenti al riferimento di programmazione associato, vedere Provider PowerShell per SQL Server.
Guida di Invoke-Sqlcmd
Il cmdlet Invoke-Sqlcmd accetta come input qualsiasi query o file script che può essere eseguito dall'utilità sqlcmd. È possibile utilizzare Get-Help per ottenere informazioni su Invoke-Sqlcmd e i relativi parametri, ma Get-Help non fornisce informazioni sulle query sqlcmd.
L'input -Query o -QueryFromFile può contenere:
Variabili e comandi di sqlcmd. Per informazioni su variabili e comandi, vedere la sezione Osservazioni di Utilità sqlcmd.
Istruzioni Transact-SQL. Per ulteriori informazioni sul linguaggio Transact-SQL, vedere Guida di riferimento a Transact-SQL (Motore di database).
Istruzioni XQuery. Per ulteriori informazioni sul linguaggio XQuery supportato da SQL Server, vedere Riferimento al linguaggio XQuery (SQL Server).
Ottenere la Guida per un cmdlet di SQL Server
Per ottenere la Guida per un cmdlet
- Eseguire Get-Help specificando il nome del cmdlet e il livello della Guida da restituire.
Esempio: cmdlet Get-Help
Negli esempi seguenti vengono restituiti vari livelli della Guida per Invoke-Sqlcmd:
## Get the basic help.
Get-Help Invoke-Sqlcmd
## Get the full help.
Get-Help Invoke-Sqlcmd –Full
## Get the parameter descriptions.
Get-Help Invoke-Sqlcmd -Parameter *
## Get the code examples.
Get-Help Invoke-Sqlcmd –Examples
## Get the syntax diagram.
Get-Help Invoke-Sqlcmd –Syntax
Ottenere un elenco di provider
Per ottenere un elenco di provider attivi
- Eseguire Get-Help specificando la categoria del provider.
Per ulteriori informazioni su come ottenere informazioni sul provider in Windows PowerShell, vedere Unità e provider.
Esempio: ottenere un elenco di provider
Questo codice restituisce un elenco dei provider attualmente abilitati nella sessione di Windows PowerShell:
Get-Help -Category provider
Ottenere la Guida sul provider SQL Server
Per ottenere la Guida sul provider
- Eseguire Get-Help specificando il nome SQLServer
Esempio: ottenere la Guida del provider SQL Server
In questo esempio vengono restituite informazioni di base sul provider di SQL Server:
Get-Help SQLServer
Elencare metodi e proprietà
Per elencare i metodi e le proprietà per un nodo in un percorso del provider SQL Server
Utilizzare il comando CD in un nodo nel percorso di SQL Server o creare un set di variabili nel percorso.
Eseguire il cmdlet Get-Member con il parametro -Tipo impostato su Metodi o Proprietà
Esempi: elencare metodi e proprietà
In questo esempio vengono elencati i metodi supportati per il nodo Database:
Set-Location SQL:\MyComputer\DEFAULT\Databases
Get-Item . | Get-Member -Type Methods
In questo esempio vengono elencate le proprietà di una variabile impostata su un oggetto della tabella SMO:
$MyVar = New-Object Microsoft.SqlServer.Management.SMO.Table
$MyVar | Get-Member -Type Properties