Add-PSSnapin

Aggiunge uno o più snap-in di Windows PowerShell alla sessione corrente.

Sintassi

Add-PSSnapin [-Name] <string[]> [-PassThru] [<CommonParameters>]

Descrizione

Il cmdlet Add-PSSnapin consente di aggiungere snap-in registrati di Windows PowerShell alla sessione corrente. Dopo avere aggiunto gli snap-in, è possibile utilizzare i cmdlet e i provider supportati dagli snap-in nella sessione corrente.

Per aggiungere lo snap-in a tutte le sessioni future di Windows PowerShell, aggiungere il comando Add-PSSnapin al profilo di Windows PowerShell. Per ulteriori informazioni, vedere about_Profiles.

Parametri

-Name <string[]>

Specifica il nome dello snap-in. (si tratta del parametro Name, non AssemblyName o ModuleName).

Per trovare i nomi degli snap-in registrati nel sistema, digitare: "Get-PSSnapin -registered".

-PassThru

Restituisce un oggetto che rappresenta ogni snap-in aggiunto. Per impostazione predefinita, il cmdlet non genera alcun output.

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Note

Per informazioni dettagliate sugli snap-in di Windows PowerShell, vedere about_Pssnapins. Per informazioni sulla creazione di uno snap-in di Windows PowerShell, vedere l'argomento relativo alla creazione di uno snap-in di Windows PowerShell in MSDN library all'indirizzo https://go.microsoft.com/fwlink/? LinkId=144762 (le informazioni potrebbero essere in lingua inglese).

Add-PSSnapin consente di aggiungere lo snap-in solo alla sessione corrente. Per aggiungere lo snap-in a tutte le sessioni di Windows PowerShell, aggiungerlo al profilo di Windows PowerShell. Per ulteriori informazioni, vedere about_Profiles.

È possibile aggiungere qualsiasi snap-in di Windows PowerShell registrato tramite l'utilità di installazione di Microsoft .NET Framework. Per ulteriori informazioni, vedere l'argomento relativo alla registrazione di cmdlet, provider e applicazioni host in MSDN Library all'indirizzo https://go.microsoft.com/fwlink/?LinkID=143619 (le informazioni potrebbero essere in lingua inglese).

Per ottenere un elenco degli snap-in registrati nel computer, digitare "Get-PSSnapin -registered".

Prima di aggiungere uno snap-in, tramite Add-PSSnapin viene verificata la versione dello snap-in per garantire che sia compatibile con la versione corrente di Windows PowerShell. Se la verifica della versione dello snap-in ha esito negativo, in Windows PowerShell viene segnalato un errore.

Esempio 1

C:\PS>add-PSSnapIn Microsoft.Exchange, Microsoft.Windows.AD

Descrizione
-----------
Tramite questo comando vengono aggiunti alla sessione corrente gli snap-in di Microsoft Exchange e di Active Directory.

Esempio 2

C:\PS>get-pssnapin -registered | add-pssnapin -passthru

Descrizione
-----------
Tramite questo comando vengono aggiunti alla sessione tutti gli snap-in di Windows PowerShell registrati. Viene utilizzato il cmdlet Get-PSSnapin insieme al parametro Registered per ottenere gli oggetti che rappresentano tutti gli snap-in registrati. L'operatore pipeline (|) passa il risultato ad Add-PSSnapin, tramite cui gli snap-in vengono aggiunti alla sessione. Il parametro PassThru restituisce oggetti che rappresentano ogni snap-in aggiunto.

Esempio 3

C:\PS>get-pssnapin

Descrizione
-----------
In questo esempio viene illustrato il processo di registrazione di uno snap-in nel sistema e la sua successiva aggiunta alla sessione. Viene utilizzato ManagementFeatures, uno snap-in fittizio implementato in un file denominato ManagementCmdlets.dll.

Con il primo comando vengono ottenuti gli snap-in aggiunti alla sessione corrente, compresi gli snap-in installati con Windows PowerShell. In questo esempio, non viene restituito ManagementFeatures. Ciò indica che non è stato aggiunto alla sessione. 

    get-pssnapin


Con il secondo comando vengono ottenuti gli snap-in registrati nel sistema (inclusi quelli già aggiunti alla sessione). Non sono inclusi gli snap-in installati con Windows PowerShell.

    get-pssnapin -registered

 
In questo caso, il comando non restituisce alcuno snap-in. Indica che lo snap-in ManagementFeatures non è stato registrato nel sistema.

Con il terzo comando viene creato un alias, "installutil", per il percorso dello strumento InstallUtil in .NET Framework.

    set-alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe


Nel quarto comando viene utilizzato lo strumento InstallUtil per registrare lo snap-in. Viene specificato il percorso a ManagementCmdlets.dll, il nome file o il "nome modulo" dello snap-in.

    installutil C:\Dev\Management\ManagementCmdlets.dll


Il quinto comando corrisponde al secondo. In questo caso viene utilizzato per verificare che lo snap-in ManagementCmdlets sia registrato.

    get-pssnapin -registered

Nel sesto comando viene utilizzato il cmdlet Add-PSSnapin per aggiungere lo snap-in ManagementFeatures alla sessione. Viene specificato il nome dello snap-in, ManagementFeatures, e non il nome file.

    add-pssnapin ManagementFeatures

Per verificare che lo snap-in venga aggiunto alla sessione, nel settimo comando viene utilizzato il parametro Module del cmdlet Get-Command. Vengono visualizzati gli elementi aggiunti alla sessione da uno snap-in o un modulo. 

    get-command -module ManagementFeatures

È inoltre possibile utilizzare la proprietà PSSnapin dell'oggetto restituito da Get-Command per trovare lo snap-in o il modulo nel quale è stato creato un cmdlet. Tramite l'ottavo comando viene utilizzata la notazione con punto per trovare il valore della proprietà PSSnapin del comando Set-Alias. 

    (get-command set-alias).pssnapin

Vedere anche

Concetti

Get-PSSnapin
Remove-PSSnapin
about_Profiles