Condividi tramite


about_PSSnapins

Descrizione breve

Descrive gli snap-in di Windows PowerShell e illustra come usarli e gestirli.

Descrizione lunga

Uno snap-in di Windows PowerShell è un assembly di Microsoft .NET Framework che può contenere provider e cmdlet di Windows PowerShell. Windows PowerShell include un set di snap-in di base, ma è possibile estendere la potenza e il valore di Windows PowerShell aggiungendo snap-in che contengono provider e cmdlet creati o ottenuti da altri utenti.

Quando si aggiunge uno snap-in, i cmdlet e i provider che contiene sono immediatamente disponibili per l'uso nella sessione corrente, ma la modifica influisce solo sulla sessione corrente.

Per aggiungere lo snap-in a tutte le sessioni future, salvarlo nel profilo di Windows PowerShell. È anche possibile usare il Export-Console cmdlet per salvare i nomi degli snap-in in in un file della console e quindi usare la configurazione salvata nelle sessioni future.

A partire da Windows PowerShell 3.0, i cmdlet forniti con PowerShell vengono inclusi nei moduli. L'eccezione è Microsoft.PowerShell.Core, che è l'unico snap-in rimanente. Lo snap-in Microsoft.PowerShell.Core viene caricato in ogni sessione per impostazione predefinita. I moduli rimanenti vengono caricati automaticamente al primo utilizzo. Per altre informazioni, vedere about_Modules.

Trovare uno snap-in

Per ottenere un elenco degli snap-in di Windows PowerShell nel computer, digitare:

Get-PSSnapin

Per ottenere lo snap-in per ogni provider di Windows PowerShell, digitare:

Get-PSProvider | Format-List name, pssnapin

Per ottenere tutti gli snap-in registrati nel sistema o per verificare che uno snap-in sia registrato, digitare:

Get-PSSnapin -registered

Per ottenere un elenco dei cmdlet in uno snap-in di Windows PowerShell, digitare:

Get-Command -Module <snap-in_name>

Installare uno snap-in

Gli snap-in predefiniti vengono registrati nel sistema e aggiunti alla sessione predefinita all'avvio di Windows PowerShell. Tuttavia, è necessario registrare snap-in creati o ottenuti da altri utenti e quindi aggiungere gli snap-in alla sessione.

Aggiungere uno snap-in alla sessione corrente

Per aggiungere uno snap-in registrato alla sessione corrente, usare il Add-PsSnapin cmdlet . Ad esempio, per aggiungere lo snap-in Microsoft SQL Server alla sessione, digitare:

Add-PSSnapin sql

Al termine del comando, i provider e i cmdlet nello snap-in sono disponibili nella sessione. Tuttavia, sono disponibili solo nella sessione corrente, a meno che non vengano salvate.

Salvare uno snap-in

Per usare uno snap-in nelle sessioni future di Windows PowerShell, aggiungere il Add-PsSnapin comando al profilo di Windows PowerShell. In alternativa, esportare i nomi di snap-in in un file della console.

Se si aggiunge il Add-PSSnapin comando al profilo, è disponibile in tutte le sessioni future di Windows PowerShell. Se si esportano i nomi degli snap-in nella sessione, è possibile usare il file di esportazione solo quando sono necessari gli snap-in.

Per aggiungere il Add-PsSnapin comando al profilo di Windows PowerShell, aprire il profilo, incollare o digitare il comando e quindi salvare il profilo. Per altre informazioni, vedere about_Profiles.

Per salvare gli snap-in da una sessione nel file della console (.psc1), usare il Export-Console cmdlet . Ad esempio, per salvare gli snap-in nella configurazione di sessione corrente nel NewConsole.psc1 file nella directory corrente, digitare:

Export-Console NewConsole

Per altre informazioni, vedere Export-Console.

Aprire Windows PowerShell usando un file della console

Per usare un file della console che include lo snap-in, avviare Windows PowerShell (powershell.exe) dal prompt dei comandi in o in cmd.exe un'altra sessione di Windows PowerShell. Usare il parametro PsConsoleFile per specificare il file della console che include lo snap-in. Ad esempio, il comando seguente avvia Windows PowerShell con il file della NewConsole.psc1 console:

PowerShell.exe -psconsolefile NewConsole.psc1

I provider e i cmdlet nello snap-in sono ora disponibili per l'uso nella sessione.

Rimuovere uno snap-in

Per rimuovere uno snap-in di Windows PowerShell dalla sessione corrente, usare il Remove-PsSnapin cmdlet . Ad esempio, per rimuovere lo snap-in di SQL Server dalla sessione corrente, digitare:

Remove-PSSnapin sql

Questo cmdlet rimuove lo snap-in dalla sessione. Lo snap-in è ancora caricato, ma i provider e i cmdlet supportati non sono più disponibili.

Eventi di snap-in dei log

A partire da Windows PowerShell 3.0, è possibile registrare eventi di esecuzione per i cmdlet nei moduli e snap-in di Windows PowerShell impostando la proprietà LogPipelineExecutionDetails di moduli e snap-in su $true. Per altre informazioni, vedere about_EventLogs.

Vedi anche