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".
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-PassThru
Restituisce un oggetto che rappresenta ogni snap-in aggiunto. Per impostazione predefinita, il cmdlet non genera alcun output.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<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.
|
Input |
Nessuno Non è possibile reindirizzare oggetti a Add-PSSnapin. |
|
Output |
Nessuno o System.Management.Automation.PSSnapInInfo Quando si utilizza il parametro PassThru, Add-PSSnapin restituisce un oggetto PSSnapInfo che rappresenta lo snap-in. Negli altri casi, il cmdlet non genera alcun output. |
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