Condividi tramite

Gestore PowerShell di SQL Server

Il provider SQL Server per Windows PowerShell espone la gerarchia degli oggetti di SQL Server in percorsi simili ai percorsi del file system. È possibile utilizzare i percorsi per individuare un oggetto e quindi utilizzare i metodi dei modelli SMO (SQL Server Management Object) per eseguire azioni sugli oggetti.

Annotazioni

Sono disponibili due moduli di SQL Server PowerShell. SqlServer e SQLPS.

Il modulo SqlServer è il modulo di PowerShell corrente da usare.

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

Il modulo SqlServer contiene versioni aggiornate dei cmdlet in SQLPS e include nuovi cmdlet per supportare le funzionalità SQL più recenti.

Installare il modulo SqlServer da PowerShell Gallery.

Per altre informazioni, vedere SQL Server PowerShell.

Vantaggi del provider PowerShell di SQL Server

I percorsi implementati dal provider SQL Server consentono di esaminare in modo semplice e interattivo tutti gli oggetti in un'istanza di SQL Server. È possibile esplorare i percorsi usando alias di Windows PowerShell simili ai comandi usati in genere per esplorare i percorsi del file system.

Gerarchia di SQL Server PowerShell

I prodotti i cui modelli di dati o oggetti possono essere rappresentati in una gerarchia usano i provider di Windows PowerShell per esporre le gerarchie. La gerarchia viene esposta usando un'unità e una struttura di percorso simile al file system di Windows.

Ogni provider di Windows PowerShell gestisce una o più unità. Ogni disco è il nodo radice di una gerarchia di oggetti correlati. Il provider SQL Server implementa un'unità SQLSERVER. Il provider definisce anche un set di cartelle primarie per l'unità SQLSERVER. Ogni cartella e le relative sottocartelle rappresentano gli oggetti a cui è possibile accedere tramite un modello a oggetti di gestione di SQL Server. Quando ci si concentra su una sottocartella in un percorso che inizia con una di queste cartelle primarie, è possibile utilizzare i metodi del modello a oggetti associato per eseguire azioni sull'oggetto rappresentato dal nodo. Le cartelle di Windows PowerShell implementate dal provider SQL Server sono elencate nella tabella seguente:

Cartella Spazio dei nomi del modello di oggetti di SQL Server Oggetti
SQLSERVER:\SQL Microsoft.SqlServer.Management.Smo
Microsoft.SqlServer.Management.Smo.Agent
Microsoft.SqlServer.Management.Smo.Broker
Microsoft.SqlServer.Management.Smo.Mail		 Oggetti di database, come tabelle, viste e procedure memorizzate.
SQLSERVER:\SQLPolicy Microsoft.SqlServer.Management.Dmf
Microsoft.SqlServer.Management.Facets		 Oggetti di gestione basati su criteri, ad esempio criteri e facet.
SQLSERVER:\SQLRegistration Microsoft.SqlServer.Management.RegisteredServers Oggetti server registrati, ad esempio gruppi di server e server registrati.
SQLSERVER:\DataCollection Microsoft.SqlServer.Management.Collector Oggetti dell'agente di raccolta dati, ad esempio set di raccolta e archivi di configurazione.
SQLSERVER:\SSIS Microsoft.SqlServer.Management.IntegrationServices Oggetti SSIS, ad esempio progetti, pacchetti e ambienti.
SQLSERVER:\XEvent Microsoft.SqlServer.Management.XEvent Eventi estesi di SQL Server
SQLSERVER:\DatabaseXEvent Microsoft.SqlServer.Management.XEventDbScoped Eventi estesi di SQL Server
SQLSERVER:\SQLAS Microsoft.AnalysisServices Oggetti di Analysis Services, ad esempio cubi, aggregazioni e dimensioni.

Ad esempio, è possibile utilizzare la cartella SQLSERVER:\SQL per avviare percorsi che rappresentano qualsiasi oggetto supportato dal modello a oggetti SMO. La parte iniziale di un percorso SQLSERVER:\SQL è SQLSERVER:\SQL\ComputerName InstanceName\. I nodi dopo il nome dell'istanza si alternano tra raccolte di oggetti, ad esempio Database o Viste, e i nomi degli oggetti ( ad esempio AdventureWorks2022). Gli schemi non sono rappresentati come classi oggetto. Quando si specifica il nodo per un oggetto di primo livello in uno schema, ad esempio una tabella o una vista, è necessario specificare il nome dell'oggetto nel formato SchemaName.ObjectName.

Nell'esempio seguente viene illustrato il percorso della tabella Vendor nello schema Di acquisto del AdventureWorks2022 database in un'istanza predefinita del motore di database nel computer locale:

SQLSERVER:\SQL\localhost\DEFAULT\Databases\AdventureWorks2022\Tables\Purchasing.Vendor

Per altre informazioni sulla gerarchia del modello a oggetti SMO, vedere /sql/relational-databases/server-management-objects-smo/smo-object-model-diagram.

I nodi della raccolta in un percorso sono associati a una classe di raccolta nel modello a oggetti associato. I nodi nome oggetto sono associati a una classe oggetto nel modello a oggetti associato, come nella tabella seguente:

Percorso Classe SMO
SQLSERVER:\SQL\MyComputer\DEFAULT\Databases Microsoft.SqlServer.Management.Smo.DatabaseCollection>
SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2022 Microsoft.SqlServer.Management.Smo.Database>

Attività del provider SQL Server

Descrizione attività Articolo
Descrive come usare i cmdlet di Windows PowerShell per spostarsi tra i nodi in un percorso e, per ogni nodo, ottenere un elenco degli oggetti in tale nodo. Esplorare i percorsi di SQL Server PowerShell
Viene descritto come utilizzare i metodi e le proprietà SMO per creare report e eseguire operazioni sull'oggetto rappresentato da un nodo in un percorso. Viene inoltre descritto come ottenere un elenco dei metodi e delle proprietà SMO per tale nodo. Usare i percorsi di PowerShell di SQL Server
Descrive la conversione di un SMO Uniform Resource Name (URN) in un percorso del provider DI SQL Server. Convert-UrnToPath
Viene descritto come aprire le connessioni di autenticazione di SQL Server usando il provider SQL Server. Per impostazione predefinita, il provider usa le connessioni di autenticazione di Windows effettuate usando le credenziali dell'account Di Windows che eseguono la sessione di Windows PowerShell. Gestire l'autenticazione in PowerShell del motore di database

Passo successivo

SQL Server PowerShell