Condividi tramite

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 cmdlet Add-PSSnapin aggiunge snap-in di Windows PowerShell registrati alla sessione corrente. Dopo aver aggiunto gli snap-in, è possibile usare 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 un comando Add-PSSnapin al profilo di Windows PowerShell. Per altre informazioni, vedere about_Profiles.

A partire da Windows PowerShell 3.0, i comandi principali inclusi in 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 di 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 cmdlet Add-PSSnapin 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 cmdlet Get-Command per trovare lo snap-in o il modulo in cui è stato originato un cmdlet. L'ottavo comando usa la notazione dot 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

In questo esempio viene illustrato il processo di registrazione di uno snap-in nel sistema e quindi l'aggiunta alla sessione. 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. Sono consentiti caratteri jolly.

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

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-PassThru

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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, questo 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 principali installati con Windows PowerShell vengono 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 più recenti con moduli di base, 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, 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 lo snap-in non riesce il controllo della versione, Windows PowerShell segnala un errore.