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.