コマンドレットのスコープ
Windows Server AppFabric 管理コマンドレットを使用するには、IIS 階層内のどこでアクションを実行するのか (サーバー、サイト、アプリケーション、またはサービス) を識別するためのスコープを指定する必要があります。
スコープの指定
次の Windows PowerShell パラメーターを AppFabric コマンドレットで使用して、コマンドレットが作用するスコープを指定できます。
| パラメーター | 指定する内容 |
|---|---|
-uri <string> |
IIS サイト、アプリケーション、仮想ディレクトリ、またはサービスの URI。コマンドレットは、そのスコープで動作します。 Uri パラメーターを使用する場合は、SiteName パラメーターまたは SiteName パラメーターと VirtualPath パラメーターのセットを使用しないでください。 |
-SiteName <string> [-VirtualPath <string>] |
SiteName パラメーターでは、Web サイトの名前を、IIS マネージャーの [接続] ウィンドウで定義されているとおりに指定します。コマンドレットは、そのサイトのスコープで動作するか、そのサイト内の特定のアプリケーション、仮想ディレクトリ、またはサービスのスコープで動作します。 SiteName パラメーターを使用する場合は、そのサイト内に存在するアプリケーション、ディレクトリ、またはサービスを指定する VirtualPath パラメーターを追加する必要があります。 アプリケーションまたは仮想ディレクトリの場合は、IIS で定義されているとおりのアプリケーションの名前が仮想パスに含まれます。 サービスの場合、仮想パスはアプリケーションの名前、スラッシュ、およびサービスの .svc ファイルまたは .xamlx ファイルの名前で構成されます。 VirtualPath パラメーターは、サイト スコープの場合は必要ありません。 仮想パスの先頭の "/" 文字は省略可能です。 SiteName パラメーターを使用する場合は、Uri パラメーターを使用しないでください。 |
-Root |
ルート アプリケーションの名前。コマンドレットは、そのスコープで動作します。 Root パラメーターを使用する場合は、SiteName、VirtualPath、または Uri パラメーターを使用しないでください。 |
-ServiceObject <ServiceInfo> |
ServiceObject の名前。コマンドレットは、そのサービスに対して動作します。 このパラメーターは、通常、Get-ASAppService コマンドレットの出力を、ServiceObject パラメーターを含むコマンドレットにパイプするために使用します。 |
-ApplicationObject <ApplicationInfo> |
ApplicationObject の名前。コマンドレットは、そのアプリケーションに対して動作します。 このパラメーターは、Get-ASApplication コマンドレットの出力を、ApplicationObject パラメーターを含むコマンドレットにパイプするために使用します。 |
-ServiceInstanceObject <ServiceInstanceInfo> |
ServiceInstanceObject の名前。コマンドレットは、そのサービスに対して動作します。 |
特定のスコープに適用される規則をいくつか次に示します。
サービス ルート スコープには、-root パラメーター フラグを使用します。
サイト スコープには、-SiteName パラメーターを使用します。
アプリケーション スコープには、–SiteName –VirtualPath パラメーター セットまたは -Uri パラメーターを使用します。
サービス スコープには、–SiteName –VirtualPath パラメーター セットまたは -Uri パラメーターを使用します。
2011-12-05