共用方式為


Cmdlet 範圍

執行許多 Microsoft AppFabric 1.1 for Windows Server 管理 Cmdlet 時都必須指定範圍,以指出要在哪個 IIS 階層 (伺服器、網站、應用程式或服務) 執行動作。

指定範圍

下列 Windows PowerShell 參數可與 AppFabric Cmdlet 搭配使用,以指定的 Cmdlet 運作範圍:

參數 用法

-uri <字串>

IIS 網站、應用程式、虛擬目錄或服務的 URI,它指定 Cmdlet 將在該範圍執行。若使用 URI 參數,請勿使用 SiteName 參數或 SiteName 與 VirtualPath 參數集。

-SiteName <字串> [-VirtualPath <字串>]

SiteName 參數可指定網站的名稱 (如在 IIS 的 [連線] 窗格中所定義),它指定 Cmdlet 將在網站的範圍或網站中包含之應用程式、虛擬目錄或服務的範圍執行。對於 SiteName 參數,您可以新增 VirtualPath 參數以識別網站包含的應用程式、目錄或服務。對於應用程式或虛擬目錄,虛擬路徑包含應用程式的名稱 (如在 IIS 中所定義)。對於服務,虛擬路徑包含應用程式的名稱、斜線,以及服務之 .svc 檔案或 .xamlx 檔案的名稱。對於網站範圍,VirtualPath 並非必要參數。虛擬路徑開頭的 "/" 字元可省略。若使用 SiteName 參數,請勿使用 URI 參數。

-Root

根應用程式的名稱,它指定 Cmdlet 將在該範圍執行。若使用 Root 參數,請勿使用 SiteName、VirtualPath 或 Uri 參數。

-ServiceObject <服務資訊>

ServiceObject 的名稱,它指定 Cmdlet 將在該服務上執行。此參數通常用來將 Get-ASAppService Cmdlet 的輸出以管道處理方式傳遞給包含 ServiceObject 參數的 Cmdlet。

-ApplicationObject <應用程式資訊>

ApplicationObject 的名稱,它指定 Cmdlet 將在該應用程式上執行。此參數是用來將 Get-ASApplication Cmdlet 的輸出以管道處理方式傳遞給包含 ApplicationObject 參數的 Cmdlet。

-ServiceInstanceObject <服務執行個體資訊>

ServiceInstanceObject 的名稱,它指定 Cmdlet 將在該服務上執行。

以下是可套用至特定範圍的一些規則:

  • 對於服務根範圍,使用 –root 參數旗標。

  • 對於網站範圍,使用 –SiteName 參數。

  • 對於應用程式範圍,使用 –SiteName –VirtualPath 參數集或 –Uri 參數。

  • 對於服務範圍,使用 –SiteName –VirtualPath 參數集或 –Uri 參數。

  2012-03-05