다음을 통해 공유


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 환경에 있는 로컬 서버에서 호스트되는 모든 서비스를 반환합니다.

Get-ASAppService –Root

-SiteName(선택 사항)

이 매개 변수를 지정하면 –Root, -Uri, –ServiceObject 매개 변수를 지정해서는 안 됩니다. 이 매개 변수를 사용하면 cmdlet은 지정한 웹 사이트에서 호스트되는 모든 서비스를 반환합니다.

Get-ASAppService –SiteName “Default Web Site”

-VirtualPath(선택 사항)

–Uri와 –ServiceObject가 둘 다 지정되지 않은 경우 -SiteName과 함께 사용하는 선택적 매개 변수입니다. 서비스 또는 응용 프로그램에 대한 가상 경로를 지정합니다. 예: /MyDir1/MyApp1/POService.svc

Get-ASAppService –SiteName “Default Web Site” –VirtualPath “/MyWFServiceApplication”

-Uri(선택 사항)

이 매개 변수를 지정할 경우 –SiteName, -VirtualPath 및 –ServiceObject를 지정하면 안 됩니다. 사이트, 응용 프로그램 또는 서비스의 URI를 지정합니다. 이 매개 변수를 지정하면 이 URI에서 사용할 수 있는 서비스만 반환됩니다.

Get-ASAppService –Uri “https://localhost/MyWFServiceApplication”

-ApplicationObject(선택 사항)

이 매개 변수를 지정할 경우 –SiteName, -VirtualPath 및 –Uri를 지정하면 안 됩니다. 이 매개 변수는 일반적으로 Get-ASAppService cmdlet에서 출력을 파이프하는 데 사용됩니다.

Get-Application | Get-ASAppService

-Count(선택 사항)

서비스 수를 반환합니다.

Get-ASAppService -Count

이 cmdlet에 대한 자세한 내용은 Get-ASAppService을 참조하십시오.

서비스 인스턴스를 가져오려면

Get-ASAppServiceInstance cmdlet은 하나 이상의 지속성 저장소에서 서비스 인스턴스 개체에 대한 정보를 표시합니다. Get-ASAppServiceInstance cmdlet은 지정된 지속성 저장소 집합을 쿼리하고 제공된 쿼리 매개 변수와 일치하는 서비스 인스턴스의 컬렉션을 반환합니다. 다음 표에서는 이 cmdlet의 매개 변수에 대해 설명합니다.

매개 변수 설명

-Root(선택 사항)

이 매개 변수를 지정할 경우 –Uri, -SiteName 및 –ServiceObject를 지정하면 안 됩니다. 이 매개 변수를 사용하면 cmdlet은 로컬 서버에 있는 모든 서비스 인스턴스를 반환합니다.

Get-ASAppServiceInstance –Root

-SiteName(선택 사항)

이 매개 변수를 지정할 경우 -Uri 및 –ServiceObject를 지정하면 안 됩니다. 사이트의 이름을 지정합니다. 이 매개 변수를 지정하면 지정한 사이트에서 호스트되는 서비스의 인스턴스만 반환됩니다.

Get-ASAppServiceInstance –SiteName “Default Web Site”

-VirtualPath(선택 사항)

–Uri와 –ServiceObject가 둘 다 지정되지 않은 경우 -SiteName과 함께 사용하는 선택적 매개 변수입니다. 서비스 또는 응용 프로그램에 대한 가상 경로를 지정합니다. 예: /MyDir1/MyApp1/POService.svc

Get-ASAppServiceInstance –SiteName “Default Web Site” –VirtualPath “/MyWFServiceApplication”

-Uri(선택 사항)

이 매개 변수를 지정할 경우 –SiteName, -VirtualPath 및 –ServiceObject를 지정하면 안 됩니다. 사이트, 응용 프로그램 또는 서비스의 URI를 지정합니다. 이 매개 변수를 지정하면 이 URI 아래에 있는 서비스 인스턴스만 반환됩니다.

Get-ASAppServiceInstance –Uri “https://localhost/MyWFServiceApplication”

-ServiceInfo(선택 사항)

이 매개 변수를 지정할 경우 –SiteName, -VirtualPath 및 –Uri를 지정하면 안 됩니다. 관련 정보를 반환할 서비스 인스턴스를 확인하는 데 사용되는 ServiceInfo 개체를 지정합니다. 이 매개 변수는 일반적으로 Get-ASAppService cmdlet에서 출력을 파이프하는 데 사용됩니다.

Get-ASAppService | Get-ASAppServiceInstance 

-ApplicationInfo(선택 사항)

이 매개 변수를 지정할 경우 –SiteName, -VirtualPath 및 –Uri를 지정하면 안 됩니다. 관련 정보를 반환할 서비스 인스턴스를 확인하는 데 사용되는 ApplicationInfo 개체를 지정합니다. 이 매개 변수는 일반적으로 Get-ASApplication cmdlet에서 출력을 파이프하는 데 사용됩니다.

Get-ASApplication | Get-ASAppServiceInstance

-Count(선택 사항)

쿼리 매개 변수가 일치하는 인스턴스의 수만 반환되도록 지정합니다.

//root level is the default level
Get-ASAppServiceInstance -Count

-CreatedTimeFrom(선택 사항)

서비스 인스턴스가 처음 시작된 시간대의 시작을 지정합니다. 이 매개 변수를 지정하면 지정된 타임스탬프에서 시작되거나 이후에 시작된 인스턴스만 반환됩니다.

Get-ASAppServiceInstance -CreatedTimeFrom 1/1/2009

-CreatedTimeTo(선택 사항)

서비스 인스턴스가 처음 시작된 시간대의 끝을 지정합니다. 이 매개 변수를 지정하면 지정된 타임스탬프 이전에 시작된 인스턴스만 반환됩니다.

Get-ASAppServiceInstance -CreatedTimeTo 6/1/2009
Get-ASAppServiceInstance -CreatedTimeFrom 1/1/2009 -CreatedTimeTo 6/1/2009

-MachineName(선택 사항)

컴퓨터 이름을 지정합니다. 이 매개 변수를 지정하면 이 컴퓨터가 잠근 서비스 인스턴스만 반환됩니다.

Get-ASAppServiceInstance -MachineName

-ModifiedTimeFrom(선택 사항)

서비스 인스턴스가 수정된 시간 범위의 시작을 지정합니다. 이 매개 변수를 지정하면 지정된 타임스탬프 이후에 수정된 인스턴스만 반환됩니다.

Get-ASAppServiceInstance -ModifiedTimeFrom 1/1/2009

-ModifiedTimeTo(선택 사항)

서비스 인스턴스가 수정된 시간 범위의 끝을 지정합니다. 이 매개 변수를 지정하면 지정된 타임스탬프 이전에 수정된 인스턴스만 반환됩니다.

Get-ASAppServiceInstance -ModifiedTimeTo 6/1/2009
Get-ASAppServiceInstance -ModifiedTimeFrom 1/1/2009 -ModifiedTimeTo 6/1/2009

-ExceptionName(선택 사항)

.NET Framework 예외의 정규화된 유형 이름을 나타내는 문자열을 지정합니다. 이 매개 변수를 지정하면 지정된 예외로 인해 종료된 서비스 인스턴스만 반환됩니다.

-MaxRows(선택 사항)

반환할 행(서비스 인스턴스) 수를 지정합니다.

Get-ASAppServiceInstance –MaxRows 100

-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입니다.

Get-ASAppServiceInstance -Status Completed

-Condition(선택 사항)

인스턴스 조건을 지정합니다. 이 매개 변수를 지정하면 지정한 조건의 서비스 인스턴스만 쿼리에 의해 반환됩니다. Condition에 사용할 수 있는 값은 Active, Idle, Exception, UserSuspension, Successful, Cancelled 및 Terminated입니다.

Get-ASAppServiceInstance -Condition Cancelled

-GroupBy(선택 사항)

반환된 서비스 인스턴스 수를 그룹화하는 데 사용되는 필드를 지정합니다. GroupBy에 사용할 수 있는 값은 UniqueApplication, UniqueService, ServiceType, Exception, Status, Site 및 MachineName입니다.

Get-ASAppServiceInstance –GroupBy Status

-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