Add-PSSnapin

  • Riferimento
Modulo:
Microsoft.PowerShell.Core

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

Sintassi

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

Descrizione

Il Add-PSSnapin cmdlet aggiunge snap-in di Windows PowerShell registrati alla sessione corrente. Dopo l'aggiunta degli snap-in è possibile usare i cmdlet e i provider supportati dagli snap-nella sessione corrente.

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

A partire da Windows PowerShell 3.0, i comandi di base di Windows PowerShell sono inclusi nei moduli. L'eccezione è Microsoft.PowerShell.Core, ovvero uno snap-in (PSSnapin). Per impostazione predefinita, alla sessione viene aggiunto solo lo snap-in Microsoft.PowerShell.Core . I moduli vengono importati automaticamente al primo utilizzo ed è possibile usare il cmdlet Import-Module per importarli.

Esempio

Esempio 1: Aggiungere snap-in

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

Questo comando aggiunge gli snap-in Microsoft Exchange e Active Directory alla sessione corrente.

Esempio 2: Aggiungere tutti gli snap-in registrati

PS C:\> Get-PSSnapin -Registered | Add-PSSnapin -Passthru

Questo comando aggiunge tutti gli snap-in di Windows PowerShell registrati alla sessione. Usa il cmdlet Get-PSSnapin con il parametro Registered per ottenere oggetti che rappresentano ognuno degli snap-in registrati. L'operatore pipeline (|) passa il risultato a Add-PSSnapin, che li aggiunge alla sessione. Il parametro PassThru restituisce oggetti che rappresentano ognuno degli snap-in aggiunti.

Esempio 3: Registrare uno snap-in e aggiungerlo

Il primo comando ottiene gli snap-in aggiunti alla sessione corrente che includono gli snap-in installati con Windows PowerShell. In questo esempio, ManagementFeatures non viene restituito. Ciò indica che non è stato aggiunto alla sessione.

Il secondo comando ottiene gli snap-in registrati nel sistema, inclusi quelli già aggiunti alla sessione. Non include gli snap-in installati con Windows PowerShell. In questo caso, il comando non restituisce snap-in. Ciò indica che lo snapin ManagementFeatures non è stato registrato nel sistema.

Il terzo comando crea un alias, installutil, per il percorso dello strumento InstallUtil in .NET Framework.

Il quarto comando usa lo strumento InstallUtil per registrare lo snap-in. Il comando specifica il percorso di ManagementCmdlets.dll, il nome del nome file o del modulo dello snap-in.

Il quinto comando è uguale al secondo comando. Questa volta viene usato per verificare che lo snap-in ManagementCmdlets sia registrato.

Il sesto comando usa il Add-PSSnapin cmdlet per aggiungere lo snap-in ManagementFeatures alla sessione. Specifica il nome dello snap-in, ManagementFeatures, non il nome del file.

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

È anche possibile utilizzare la proprietà PSSnapin dell'oggetto restituito dal Get-Command cmdlet per trovare lo snap-in o il modulo in cui è stato originato un cmdlet. L'ottavo comando usa la notazione punto per trovare il valore della proprietà PSSnapin del cmdlet Set-Alias.

PS C:\> Get-PSSnapin
PS C:\> Get-PSSnapin -Registered
PS C:\> Set-Alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe
PS C:\> installutil C:\Dev\Management\ManagementCmdlets.dll
PS C:\> Get-PSSnapin -Registered
PS C:\> add-pssnapin ManagementFeatures
PS C:\> Get-Command -Module ManagementFeatures
PS C:\> (Get-Command Set-Alias).pssnapin

Questo esempio illustra il processo di registrazione di uno snap-in nel sistema e la sua aggiunta alla sessione dell'utente. Usa ManagementFeatures, uno snap-in fittizio implementato in un file denominato ManagementCmdlets.dll.

Parametri

-Name

Specifica il nome dello snap-in. Nome, non AssemblyName o ModuleName. I caratteri jolly sono consentiti.

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

None or System.Management.Automation.PSSnapInInfo

Questo cmdlet restituisce un oggetto PSSnapInInfo che rappresenta lo snap-in se si specifica il parametro PassThru . In caso contrario, il cmdlet non genera alcun output.

Note

Windows PowerShell include gli alias seguenti per Add-PSSnapin:

  • asnp

A partire da Windows PowerShell 3.0, i comandi di base installati con Windows PowerShell sono inclusi nei moduli. In Windows PowerShell 2.0 e nei programmi host che creano sessioni meno recenti in versioni successive di Windows PowerShell, i comandi principali vengono inseriti in snap-in (PSSnapins). L'eccezione è Microsoft.PowerShell.Core, che è sempre uno snap-in. Inoltre, le sessioni remote, ad esempio quelle avviate dal cmdlet New-PSSession, sono sessioni di tipo precedente che includono snap-in di base.

Per informazioni sul metodo CreateDefault2 che crea sessioni in stile più recente con moduli principali, vedere Metodo CreateDefault2.

Per altre informazioni sugli snap-in, vedere about_PSSnapins e Come creare uno snap-in di Windows PowerShell.

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

È possibile aggiungere qualsiasi snap-in registrato usando l'utilità di installazione di Microsoft .NET Framework. Per altre informazioni, vedere Come registrare cmdlet, provider e applicazioni host.

Per ottenere un elenco di snap-in registrati nel computer, digitare Get-PSSnapin -Registered.

Prima di aggiungere uno snap-in, Add-PSSnapin controlla la versione dello snap-in per verificare che sia compatibile con la versione corrente di Windows PowerShell. Se il controllo della versione dello snap-in non riesce, Windows PowerShell restituisce un errore.