Windows Server AppFabric Cmdlet을 사용하여 서비스 표시
이 항목에서는 AppFabric cmdlet을 사용하여 서비스 및 서비스 인스턴스를 표시하는 방법에 대해 설명합니다.
참고
AppFabric cmdlet을 수동으로 실행하려면 AppFabric용 Windows PowerShell 콘솔을 열고 해당 cmdlet을 입력한 다음 Enter 키를 누릅니다. cmdlet 실행에 대한 자세한 내용은 Windows Server AppFabric Cmdlet 실행을 참조하십시오. 이 문서의 구문 명령문에 사용되는 클래스나 일반 매개 변수에 대한 자세한 내용은 Windows Server AppFabric용 Windows PowerShell 참조를 참조하십시오.
응용 프로그램의 서비스를 가져오려면
Get-ASAppService cmdlet은 지정한 범위에서 사용할 수 있는 모든 서비스를 표시합니다. 다음 표에서는 이 cmdlet의 매개 변수에 대해 설명합니다.
| 매개 변수 | 설명 |
|---|---|
-Root(선택 사항) |
이 매개 변수를 지정할 경우 –Uri, -SiteName 및 –ServiceObject를 지정하면 안 됩니다. 이 매개 변수를 사용하면 cmdlet은 IIS/WAS 환경에 있는 로컬 서버에서 호스트되는 모든 서비스를 반환합니다. |
-SiteName(선택 사항) |
이 매개 변수를 지정하면 –Root, -Uri, –ServiceObject 매개 변수를 지정해서는 안 됩니다. 이 매개 변수를 사용하면 cmdlet은 지정한 웹 사이트에서 호스트되는 모든 서비스를 반환합니다. |
-VirtualPath(선택 사항) |
–Uri와 –ServiceObject가 둘 다 지정되지 않은 경우 -SiteName과 함께 사용하는 선택적 매개 변수입니다. 서비스 또는 응용 프로그램에 대한 가상 경로를 지정합니다. 예: /MyDir1/MyApp1/POService.svc |
-Uri(선택 사항) |
이 매개 변수를 지정할 경우 –SiteName, -VirtualPath 및 –ServiceObject를 지정하면 안 됩니다. 사이트, 응용 프로그램 또는 서비스의 URI를 지정합니다. 이 매개 변수를 지정하면 이 URI에서 사용할 수 있는 서비스만 반환됩니다. |
-ApplicationObject(선택 사항) |
이 매개 변수를 지정할 경우 –SiteName, -VirtualPath 및 –Uri를 지정하면 안 됩니다. 이 매개 변수는 일반적으로 Get-ASAppService cmdlet에서 출력을 파이프하는 데 사용됩니다. |
-Count(선택 사항) |
서비스 수를 반환합니다. |
이 cmdlet에 대한 자세한 내용은 Get-ASAppService를 참조하십시오.
서비스 인스턴스를 가져오려면
Get-ASAppServiceInstance cmdlet은 하나 이상의 지속성 저장소에서 서비스 인스턴스 개체에 대한 정보를 표시합니다. Get-ASAppServiceInstance cmdlet은 지정된 지속성 저장소 집합을 쿼리하고 제공된 쿼리 매개 변수와 일치하는 서비스 인스턴스의 컬렉션을 반환합니다. 다음 표에서는 이 cmdlet의 매개 변수에 대해 설명합니다.
| 매개 변수 | 설명 |
|---|---|
-Root(선택 사항) |
이 매개 변수를 지정할 경우 –Uri, -SiteName 및 –ServiceObject를 지정하면 안 됩니다. 이 매개 변수를 사용하면 cmdlet은 로컬 서버에 있는 모든 서비스 인스턴스를 반환합니다. |
-SiteName(선택 사항) |
이 매개 변수를 지정할 경우 -Uri 및 –ServiceObject를 지정하면 안 됩니다. 사이트의 이름을 지정합니다. 이 매개 변수를 지정하면 지정한 사이트에서 호스트되는 서비스의 인스턴스만 반환됩니다. |
-VirtualPath(선택 사항) |
–Uri와 –ServiceObject가 둘 다 지정되지 않은 경우 -SiteName과 함께 사용하는 선택적 매개 변수입니다. 서비스 또는 응용 프로그램에 대한 가상 경로를 지정합니다. 예: /MyDir1/MyApp1/POService.svc |
-Uri(선택 사항) |
이 매개 변수를 지정할 경우 –SiteName, -VirtualPath 및 –ServiceObject를 지정하면 안 됩니다. 사이트, 응용 프로그램 또는 서비스의 URI를 지정합니다. 이 매개 변수를 지정하면 이 URI 아래에 있는 서비스 인스턴스만 반환됩니다. |
-ServiceInfo(선택 사항) |
이 매개 변수를 지정할 경우 –SiteName, -VirtualPath 및 –Uri를 지정하면 안 됩니다. 관련 정보를 반환할 서비스 인스턴스를 확인하는 데 사용되는 ServiceInfo 개체를 지정합니다. 이 매개 변수는 일반적으로 Get-ASAppService cmdlet에서 출력을 파이프하는 데 사용됩니다. |
-ApplicationInfo(선택 사항) |
이 매개 변수를 지정할 경우 –SiteName, -VirtualPath 및 –Uri를 지정하면 안 됩니다. 관련 정보를 반환할 서비스 인스턴스를 확인하는 데 사용되는 ApplicationInfo 개체를 지정합니다. 이 매개 변수는 일반적으로 Get-ASApplication cmdlet에서 출력을 파이프하는 데 사용됩니다. |
-Count(선택 사항) |
쿼리 매개 변수가 일치하는 인스턴스의 수만 반환되도록 지정합니다. |
-CreatedTimeFrom(선택 사항) |
서비스 인스턴스가 처음 시작된 시간대의 시작을 지정합니다. 이 매개 변수를 지정하면 지정된 타임스탬프에서 시작되거나 이후에 시작된 인스턴스만 반환됩니다. |
-CreatedTimeTo(선택 사항) |
서비스 인스턴스가 처음 시작된 시간대의 끝을 지정합니다. 이 매개 변수를 지정하면 지정된 타임스탬프에서 시작되거나 이전에 시작된 인스턴스만 반환됩니다. |
-MachineName(선택 사항) |
컴퓨터 이름을 지정합니다. 이 매개 변수를 지정하면 이 컴퓨터가 잠근 서비스 인스턴스만 반환됩니다. |
-ModifiedTimeFrom(선택 사항) |
서비스 인스턴스가 수정된 시간대의 시작을 지정합니다. 이 매개 변수를 지정하면 지정된 타임스탬프에서 수정되거나 이후에 수정된 인스턴스만 반환됩니다. |
-ModifiedTimeTo(선택 사항) |
서비스 인스턴스가 수정된 시간대의 끝을 지정합니다. 이 매개 변수를 지정하면 지정된 타임스탬프에서 수정되거나 이전에 수정된 인스턴스만 반환됩니다. |
-ExceptionName(선택 사항) |
.NET Framework 예외의 정규화된 유형 이름을 나타내는 문자열을 지정합니다. 이 매개 변수를 지정하면 지정된 예외로 인해 종료된 서비스 인스턴스만 반환됩니다. |
-MaxRows(선택 사항) |
반환할 행(서비스 인스턴스) 수를 지정합니다. |
-InstanceId(선택 사항) |
반환할 서비스 인스턴스의 인스턴스 ID(GUID로 지정됨)를 지정합니다. 인스턴스 ID는 서비스 인스턴스를 고유하게 식별합니다. 이 매개 변수를 지정하면 이 ID를 가진 인스턴스가 있는 경우 반환됩니다. |
-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(선택 사항) |
인스턴스 상태를 지정합니다. 이 매개 변수를 지정하면 지정한 상태의 서비스 인스턴스만 쿼리에 의해 반환됩니다. Status에 사용할 수 있는 값은 Running, Suspended 및 Completed입니다. |
-Condition(선택 사항) |
인스턴스 조건을 지정합니다. 이 매개 변수를 지정하면 지정한 조건의 서비스 인스턴스만 쿼리에 의해 반환됩니다. Condition에 사용할 수 있는 값은 Active, Idle, Exception, UserSuspension, Successful, Cancelled 및 Terminated입니다. |
-GroupBy(선택 사항) |
반환된 서비스 인스턴스 수를 그룹화하는 데 사용되는 필드를 지정합니다. GroupBy에 사용할 수 있는 값은 UniqueApplication, UniqueService, ServiceType, Exception, Status, Site 및 MachineName입니다. |
-OrderBy(선택 사항) |
마지막 업데이트 시간을 내림차순으로 정렬한 서비스 인스턴스를 표시합니다. |
-ExcludeSubFolders(선택 사항) |
이 매개 변수를 지정하면 포함하는 응용 프로그램의 결과에서 하위 응용 프로그램에 있는 인스턴스의 결과를 제외합니다. |
-Timeout(선택 사항) |
cmdlet이 데이터베이스로부터 응답을 기다리는 시간을 지정합니다. 값은 hh:mm:ss 형식의 시간 값입니다. 최소값은 00:00:01(1초)이고 최대값은 TimeSpan.MaxValue입니다. 생략된 경우 기본값은 00:02:00(2분)입니다. |
-ReturnBinaryProperties(선택 사항) |
이 매개 변수를 지정하면 반환된 InstanceInfo 개체에서 이진 메타데이터 속성의 배열을 반환합니다. |
이 cmdlet에 대한 자세한 내용은 Get-ASAppServiceInstance를 참조하십시오.
2011-12-05