Get-PSSnapin
コンピューター上の Windows PowerShell スナップインを取得します。
構文
Default (既定)
Get-PSSnapin
[[-Name] <String[]>]
[-Registered]
[<CommonParameters>]
説明
Get-PSSnapin コマンドレットは、現在のセッションに追加された Windows PowerShell スナップイン、またはシステムに登録されている Windows PowerShell スナップインを取得します。 このコマンドレットでは、スナップインが検出された順序で一覧表示されます。
Get-PSSnapin は登録されたスナップインのみを取得します。Windows PowerShell スナップインを登録するには、Microsoft .NET Framework 2.0 に含まれている InstallUtil ツールを使用します。 詳細については、「コマンドレット、プロバイダー、およびホスト アプリケーションを登録する方法」を参照してください。
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 スナップインのみを取得します。ワイルドカード文字を使用できます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Registered
このコマンドレットが、まだセッションに追加されていない場合でも、システムに登録されている Windows PowerShell スナップインを取得することを示します。
Windows PowerShell でインストールされているスナップインは、この一覧には表示されません。
このパラメーターを指定しない場合、Get-PSSnapin はセッションに追加された Windows PowerShell スナップインを取得します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
None
このコマンドレットに入力をパイプすることはできません。
出力
PSSnapInInfo
Get-PSSnapin は、取得するスナップインごとにオブジェクトを返します。
メモ
Windows PowerShell には、Get-PSSnapinの次のエイリアスが含まれています。
gsnp
Windows PowerShell 3.0 以降では、Windows PowerShell と共にインストールされるコア コマンドはモジュールにパッケージ化されています。 Windows PowerShell 2.0 と、それ以降のバージョンの Windows PowerShell で古いスタイルのセッションを作成するホスト プログラムでは、コア コマンドはスナップイン (PSSnapin) にパッケージ化されます。 例外は Microsoft.PowerShell.Core です。これは常にスナップインです。 また、New-PSSession コマンドレットによって開始されたリモート セッションは、コア スナップインを含む古いスタイルのセッションです。
コア モジュールを使用して新しいスタイルのセッションを作成する CreateDefault2 メソッドの詳細については、「CreateDefault2 メソッド 参照してください。