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