Get-PSSnapin
コンピューター上の Windows PowerShell スナップインを取得します。
構文
Get-PSSnapin
[[-Name] <String[]>]
[-Registered]
[<CommonParameters>]
説明
Get-PSSnapin コマンドレットは、現在のセッションに追加された、またはシステムに登録されているWindows PowerShell スナップインを取得します。 このコマンドレットでは、スナップインが検出された順序で一覧表示されます。
Get-PSSnapin は、登録済みのスナップインのみを取得します。Windows PowerShell スナップインを登録するには、Microsoft .NET Framework 2.0 に付属の InstallUtil ツールを使用します。 詳細については、「MSDN ライブラリ でコマンドレット、プロバイダー、ホスト アプリケーションを登録する方法 」を参照してください。
Windows PowerShell 3.0 以降では、Windows PowerShellに含まれるコア コマンドはモジュールにパッケージ化されています。 例外は、スナップイン (PSSnapin) の Microsoft.PowerShell.Core です。 既定では、Microsoft.PowerShell.Core スナップインのみがセッションに追加されます。 モジュールは最初の使用時に自動的にインポートされ、Import-Module コマンドレットを使用してインポートできます。
例
例 1: 現在読み込まれているスナップインを取得する
PS C:\> Get-PSSnapIn
このコマンドは、セッションで現在読み込まれている Windows PowerShell スナップインを取得します。 これには、Windows PowerShell でインストールされたスナップインや、セッションに追加されたスナップインが含まれます。
例 2: 登録されているスナップインを取得する
PS C:\> get-PSSnapIn -Registered
このコマンドは、コンピューターに登録された Windows PowerShell スナップイン (既にセッションに追加されているスナップインを含む) を取得します。 Windows PowerShell でインストールされたスナップイン、またはシステムに登録されていない Windows PowerShell スナップインのダイナミック リンク ライブラリ (DLL) は、出力に含まれません。
例 3: 文字列に一致する現在のスナップインを取得する
PS C:\> Get-PSSnapIn -Name smp*
このコマンドは、smp で始まる名前を持つ現在のセッションのWindows PowerShell スナップインを取得します。
パラメーター
-Name
スナップイン名の配列を指定します。 このコマンドレットは、指定したWindows PowerShell スナップインのみを取得します。ワイルドカード文字を使用できます。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Registered
このコマンドレットは、まだセッションに追加されていない場合でも、システムに登録されているWindows PowerShell スナップインを取得することを示します。
Windows PowerShell でインストールされたスナップインは、この一覧に表示されません。
このパラメーターを指定しないと、Get-PSSnapin はセッションに追加されたWindows PowerShell スナップインを取得します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
None
パイプを使用してこのコマンドレットに入力を渡すことはできません。
出力
Get-PSSnapin は、取得する各スナップインのオブジェクトを返します。
メモ
Windows PowerShell 3.0 以降では、Windows PowerShellと共にインストールされるコア コマンドはモジュールにパッケージ化されています。 Windows PowerShell 2.0 およびそれ以降のバージョンのWindows PowerShellで古いスタイルのセッションを作成するホスト プログラムでは、コア コマンドはスナップイン (PSSnapin) にパッケージ化されています。 例外は Microsoft.PowerShell.Core です。これは常にスナップインです。 また、New-PSSession コマンドレットによって開始されるリモート セッションは、コア スナップインを含む古いスタイルのセッションです。
コア モジュールを使用して新しいスタイルのセッションを作成する CreateDefault2 メソッドの詳細については、MSDN ライブラリの CreateDefault2 メソッド に関するページを参照してください。