使用 AppFabric Cmdlet 來顯示服務
此主題說明如何使用 AppFabric Cmdlet 來顯示服務與服務執行個體。
注意
若要以手動方式執行 AppFabric Cmdlet，請開啟 AppFabric 的 Windows PowerShell 主控台，輸入適當的 Cmdlet，然後按下 ENTER。如需有關執行 Cmdlet 的詳細資訊，請參閱執行 AppFabric Cmdlet。如需有關此文件之語法陳述式中使用之任何類別或常用參數的詳細資訊，請參閱 AppFabric 的 Windows PowerShell 參考。
取得應用程式的服務
Get-ASAppService Cmdlet 可顯示指定範圍中的所有可用服務。下表說明此 Cmdlet 的參數。
| 參數 | 描述 |
|---|---|
-Root (可省略) |
若指定此參數，則不能指定 -Uri、-SiteName 或 -ServiceObject 參數。使用此參數時，Cmdlet 會傳回在 IIS/WAS 環境之本機伺服器主控的所有服務。 |
-SiteName (可省略) |
若指定此參數，則不能指定 -Root、-Uri 或 -ServiceObject 參數。使用此參數時，Cmdlet 會傳回在指定之網站上主控的所有服務。 |
-VirtualPath (可省略) |
用於搭配 -SiteName 使用的選擇性參數 (當未指定 -Uri 或 -ServiceObject 時)。指定服務或應用程式的虛擬路徑 (例如，/MyDir1/MyApp1/POService.svc)。 |
-Uri (可省略) |
若指定此參數，則不能指定 -SiteName、-VirtualPath 或 -ServiceObject。指定網站、應用程式或服務的 URI。若指定此參數，則只會傳回此 URI 下可用的服務。 |
-ApplicationObject (可省略) |
若指定此參數，則不能指定 -SiteName、-VirtualPath 或 -Uri。此參數通常用於透過管道處理方式將 Get-ASAppService Cmdlet 的輸出傳遞給另一個 Cmdlet。 |
-Count (可省略) |
傳回服務的計數。 |
如需有關此 Cmdlet 的詳細資訊，請參閱 Get-ASAppService。
取得服務執行個體
Get-ASAppServiceInstance Cmdlet 可顯示有關來自一或多個持續性儲存區之服務執行個體物件的資訊。Get-ASAppServiceInstance Cmdlet 會查詢指定的一組持續性儲存區，並傳回符合所提供查詢參數的服務執行個體集合。下表說明此 Cmdlet 的參數。
| 參數 | 描述 |
|---|---|
-Root (可省略) |
若指定此參數，則不能指定 -Uri、-SiteName 或 -ServiceObject 參數。使用此參數時，Cmdlet 會傳回本機伺服器上的所有服務執行個體。 |
-SiteName (可省略) |
若指定此參數，則不能指定 -Uri 或 -ServiceObject。指定網站的名稱。若指定此參數，則只會傳回在所指定網站上主控之服務的執行個體。 |
-VirtualPath (可省略) |
用於搭配 -SiteName 使用的選擇性參數 (當未指定 -Uri 或 -ServiceObject 時)。指定服務或應用程式的虛擬路徑 (例如，/MyDir1/MyApp1/POService.svc)。 |
-Uri (可省略) |
若指定此參數，則不能指定 -SiteName、-VirtualPath 或 -ServiceObject。指定網站、應用程式或服務的 URI。若指定此參數，則只會傳回此 URI 下的服務執行個體。 |
-ServiceInfo (可省略) |
若指定此參數，則不能指定 -SiteName、-VirtualPath 或 -Uri。指定 ServiceInfo 物件，供系統用來決定要傳回其相關資訊的服務執行個體。此參數通常用於透過管道處理方式將 Get-ASAppService Cmdlet 的輸出傳遞給另一個 Cmdlet。 |
-ApplicationInfo (可省略) |
若指定此參數，則不能指定 -SiteName、-VirtualPath 或 -Uri。指定 ApplicationInfo 物件，供系統用來決定將傳回其相關資訊的服務執行個體。此參數通常用於透過管道處理方式將 Get-ASApplication Cmdlet 的輸出傳遞給另一個 Cmdlet。 |
-Count (可省略) |
指定只傳回符合查詢參數的執行個體數目。 |
-CreatedTimeFrom (可省略) |
指定服務執行個體首次啟動的時間範圍開始點。若指定此參數，則只會傳回在所指定時間戳記當時或之後啟動的執行個體。 |
-CreatedTimeTo (可省略) |
指定服務執行個體首次啟動的時間範圍結束點。若指定此參數，則只會傳回在所指定時間戳記當時或之前啟動的執行個體。 |
-MachineName (可省略) |
指定電腦名稱。若指定此參數，則只會傳回由此電腦鎖定的服務執行個體。 |
-ModifiedTimeFrom (可省略) |
指定服務執行個體被修改的時間範圍開始點。若指定此參數，則只會傳回在所指定時間戳記當時或之後修改的執行個體。 |
-ModifiedTimeTo (可省略) |
指定服務執行個體被修改的時間範圍結束點。若指定此參數，則只會傳回在所指定時間戳記當時或之前修改的執行個體。 |
-ExceptionName (可省略) |
指定代表 .NET Framework 例外狀況之完整型別名稱的字串。若指定此參數，則只會傳回因為指定之例外狀況而終止的服務執行個體。 |
-MaxRows (可省略) |
指定要傳回的服務執行個體列數上限。 |
-InstanceId (可省略) |
指定要傳回之服務執行個體的執行個體識別碼 (以 GUID 方式指定)。執行個體識別碼可唯一識別服務執行個體。若指定此參數，則會傳回具有此識別碼的執行個體 (如果有的話)。 |
-ServiceType (可省略) |
依類型指定服務。若指定此參數，則只會傳回具有所指定類型的服務執行個體。您可以使用完整/部分路徑或完整/部分合格 .NET Framework 名稱與命名空間，來表示服務類型。依命名空間指定服務類型時，必須使用 "#" 字元來分隔服務類型與命名空間。例如，若完整的 .NET Framework CLR 服務名稱是 Contoso.Web.Sales.POService，則參數值應為 "Contoso.Web.Sales#POService"。 您無法明確地指定萬用字元；但是，此參數在所指定值前後包含隱含的萬用字元 (”*”)。例如，系統會將 "Contoso/Service.svc" 視為 "*Contoso/Service.svc*"，並將 "Sales#POService" 視為 "*Sales#POService*"。 |
-Status (可省略) |
指定執行個體狀態。若指定此參數，則查詢只會傳回具有所指定狀態的服務執行個體。可能的狀態值如下：「執行中」、「已暫停」與「已完成」。 |
-Condition (可省略) |
指定執行個體條件。若指定此參數，則查詢只會傳回具有所指定條件的服務執行個體。可能的條件值如下：「作用中」、「閒置」、「例外狀況」、「使用者擱置」、「成功」、「已取消」與「已終止」。 |
-GroupBy (可省略) |
指定用來將所傳回之服務執行個體計數分組的欄位。可能的 GroupBy 值如下：UniqueApplication、UniqueService、ServiceType、「例外狀況」、「狀態」、「網站」與 MachineName。 |
-OrderBy (可省略) |
顯示以服務執行個體上次更新時間排序 (遞減順序) 的服務執行個體清單。 |
-ExcludeSubFolders (可省略) |
若指定此參數，則會排除包含執行個體之應用程式中子應用程式的執行個體結果。 |
-Timeout (可省略) |
指定 Cmdlet 等候資料庫傳回回應的時間。此值必須是格式為 hh:mm:ss 的時間值。最小值是 00:00:01 (1 秒)，而最大值是 TimeSpan.MaxValue。若省略此參數，則預設值為 00:02:00 (2 分鐘)。 |
-ReturnBinaryProperties (可省略) |
若指定此參數，則會從傳回的 InstanceInfo 物件傳回二進位中繼資料屬性陣列。 |
如需有關此 Cmdlet 的詳細資訊，請參閱 Get-ASAppServiceInstance。
2012-03-05