Windows Server AppFabric Cmdlet을 사용하여 제한 구성

  • 아티클

이 항목에서는 AppFabric cmdlet을 사용하여 제한 매개 변수 값을 가져오거나 설정하는 방법을 설명합니다.

참고

AppFabric cmdlet을 대화식으로 실행하려면 Windows Server AppFabric용 Windows PowerShell 콘솔을 사용하여 해당 cmdlet을 입력한 다음 Enter 키를 눌러야 합니다. 일반적인 AppFabric cmdlet 실행에 대한 자세한 내용은 Windows Server AppFabric Cmdlet 실행을 참조하십시오.

cmdlet을 사용하여 제한 설정을 가져오려면

AppFabric Windows PowerShell 콘솔에서 Get-ASAppServiceThrottling cmdlet을 실행하여 제한 매개 변수 값을 가져옵니다. 이 cmdlet은 범위 매개 변수에 지정된 범위와 연결된 구성 파일에서 serviceThrottling 요소의 maxConcurrentCalls, maxConcurrentSessions 및 maxConcurrentInstances 특성 값을 검색합니다.

다음 목록은 이 cmdlet과 함께 사용할 수 있는 여러 구문을 보여 줍니다. 범위 매개 변수(-SiteName, -VirtualPath, -Uri 등)에 대한 자세한 내용은 cmdlet 범위를 참조하고, 파이프 매개 변수(ApplicationInfo 및 ServiceInfo)에 대한 자세한 내용은 cmdlet 파이프를 참조하십시오.

Get-ASAppServiceThrottling cmdlet의 구문 옵션

// to get throttling settings at the root level
Get-ASAppServiceThrottling -Root

//sample output from the command
MaxConcurrentCalls       : 16
MaxConcurrentInstances   : 26
MaxConcurrentSessions    : 10
IsLocal                  : True
BehaviorName             : 

// to get throttling settings at the site level
Get-ASAppServiceThrottling [-SiteName] <String> 

// to get throttling settings at an application or a service level that the virtual path points to
Get-ASAppServiceThrottling [-SiteName] <String> [-VirtualPath] <String>] 

// to get throttling settings at a site, application, or service level that an URI points to
Get-ASAppServiceThrottling [-Uri] <Uri> 

// to get throttling settings at an application level specified by the ApplicationObject; used mainly in piping scenarios
Get-ASAppServiceThrottling -ApplicationObject 
Ex: Get-Application <use scope parameters SiteName or Uri to resolve to a Web site> | Get-ASAppServiceThrottling

// to get throttling settings at a service level specified by the ServiceObject; used mainly in piping scenarios
Get-ASAppServiceThrottling -ServiceObject 
Ex: Get-ApplicationService <use scope parameters VirtualPath or Uri to resolve to an application> | Get-ASAppServiceThrottling

cmdlet을 사용하여 제한 설정을 설정하려면

AppFabric Windows PowerShell 콘솔에서 Set-ASAppServiceThrottling cmdlet을 실행하여 제한 매개 변수 값을 설정합니다. 이 cmdlet은 범위 매개 변수에 지정된 범위와 연결된 구성 파일에서 serviceThrottling 요소의 maxConcurrentCalls, maxConcurrentSessions 및 maxConcurrentInstances 특성 값을 설정합니다. serviceThrottling 요소가 없는 경우 이 cmdlet은 요소를 만든 다음 값을 설정합니다.

이 항목의 끝 부분에 정의된 범위 매개 변수와 파이프 매개 변수를 사용할 수 있습니다. 또한 다음 제한 매개 변수를 이 cmdlet과 함께 사용하여 지정된 범위와 연결된 구성 파일에서 serviceThrottling 요소의 maxConcurrentCalls, maxConcurrentSessions 및 maxConcurrentInstances 특성 값을 설정할 수도 있습니다. 변경할 매개 변수만 전달해야 합니다. 예를 들어, 최대 동시 호출 수 매개 변수의 값을 변경하려면 적절한 값 집합과 함께 MaxConcurrentCalls 매개 변수를 전달합니다.

제한 매개 변수

항목

설명

MaxConcurrentCalls

서비스 호스트가 한 번에 처리할 수 있는 메시지 수에 대한 제한을 지정합니다. 처리 중인 호출 수가 이 값과 같으면 새 호출은 활성 호출 중 하나가 완료될 때까지 대기 상태가 됩니다. 이 매개 변수에 대해 허용되는 값의 범위는 0 ~ Int32.MaxValue입니다. 이 매개 변수를 0으로 설정하는 것은 값을 Int32.MaxValue로 설정하는 것과 같습니다.

MaxConcurrentInstances

서비스 호스트가 한 번에 실행할 수 있는 인스턴스 수에 대한 제한을 지정합니다. 실행 중인 인스턴스 수가 이 값과 같으면 추가 인스턴스 생성에 대한 요청은 실행 중인 인스턴스 중 하나가 완료될 때까지 대기 상태가 됩니다. 이 매개 변수에 대해 허용되는 값의 범위는 1 ~ Int32.MaxValue입니다.

MaxConcurrentSessions

서비스 호스트가 수용할 수 있는 세션 수에 대한 제한을 지정합니다. 서비스 호스트는 제한을 초과하더라도 연결을 수용하지만 제한 미만의 채널만 활성 상태가 됩니다(채널에서 메시지를 읽음). 이 매개 변수에 대해 허용되는 값의 범위는 0 ~ Int32.MaxValue입니다. 이 값을 0으로 설정하면 값을 Int32.MaxValue로 설정하는 것과 같습니다.

범위 매개 변수(-SiteName, -VirtualPath, -Uri 등)에 대한 자세한 내용은 cmdlet 범위를 참조하고, 파이프 매개 변수(ApplicationInfo 및 ServiceInfo)에 대한 자세한 내용은 cmdlet 파이프를 참조하십시오.

Set-ASAppServiceThrottling cmdlet의 구문 옵션


// to set throttling settings at the root level
Set-ASAppServiceThrottling -Root -MaxConcurrentCalls <Int32> -MaxConcurrentInstances <Int32> -MaxConcurrentSessions <Int32> 

// to set throttling settings at the Web site level
Set-ASAppServiceThrottling -SiteName <String> -MaxConcurrentCalls <Int32> -MaxConcurrentInstances <Int32> -MaxConcurrentSessions <Int32> 

// to set throttling settings at application or service level that the virtual path points to
Set-ASAppServiceThrottling -SiteName <String> -VirtualPath <String> -MaxConcurrentCalls <Int32> -MaxConcurrentInstances <Int32> -MaxConcurrentSessions <Int32> 

// to set throttling settings at a site, application, or service level that an URI points to
Set-ASAppServiceThrottling -Uri <Uri> -MaxConcurrentCalls <Int32> -MaxConcurrentInstances <Int32> -MaxConcurrentSessions <Int32> 

// to get throttling settings at an application level specified by the ApplicationObject; used mainly in piping scenarios
Set-ASAppServiceThrottling -ApplicationObject <ApplicationInfo> -MaxConcurrentCalls <Int32> -MaxConcurrentInstances <Int32> -MaxConcurrentSessions <Int32>
// Ex: Get-ASApplication <use scope parameters SiteName or Uri to resolve to a Web site> | Set-ASAppServiceThrottling -MaxConcurrentCalls 20 -MaxConcurrentInstances 30 -MaxConcurrentSessions 15

// to set throttling settings at a service level specified by the ServiceObject; used mainly in piping scenarios
Set-ASAppServiceThrottling -ServiceObject <ServiceInfo> -MaxConcurrentCalls <Int32> -MaxConcurrentInstances <Int32> -MaxConcurrentSessions <Int32> 
// Ex: Get-ASApplicationService <use scope parameters SiteName or Uri to resolve to an application> | Set-ASAppServiceThrottling -MaxConcurrentCalls 20 -MaxConcurrentInstances 30 -MaxConcurrentSessions 15

  2011-12-05