Configurar limitação usando cmdlets do Windows Server AppFabric

Artigo
12/05/2011

Este tópico descreve como obter ou definir valores para parâmetros de limite máximo usando cmdlets do AppFabric.

Dica

Para executar interativamente um cmdlet do AppFabric, é necessário usar o console do Windows PowerShell para Windows Server AppFabric, inserir o cmdlet adequado e pressionar ENTER. Para obter mais informações sobre como executar cmdlets do AppFabric, em geral, consulte Executando cmdlets do Windows Server AppFabric.

Para obter configurações de limite máximo usando cmdlets

No console do AppFabric Windows PowerShell, execute o cmdlet Get-ASAppServiceThrottling para obter valores para os parâmetros de limite máximo. Esse cmdlet recupera os valores dos atributos maxConcurrentCalls, maxConcurrentSessions e maxConcurrentInstances do elemento serviceThrottling do arquivo de configuração associado ao escopo especificado pelos parâmetros de escopo.

A lista a seguir mostra sintaxes diferentes que podem ser usadas com esse cmdlet. Para obter informações detalhadas sobre parâmetros de escopo (-SiteName, -VirtualPath, -Uri, etc.), consulte Escopo do cmdlet e para obter informações detalhadas sobre parâmetros de pipe (ApplicationInfo e ServiceInfo), consulte Pipe de cmdlet.

Opções de sintaxe para o cmdlet Get-ASAppServiceThrottling

// 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

Para definir configurações de limite máximo usando cmdlets

No console do AppFabric Windows PowerShell, execute o cmdlet Set-ASAppServiceThrottling para obter valores para os parâmetros de limite máximo. Esse cmdlet define os valores dos atributos maxConcurrentCalls, maxConcurrentSessions e maxConcurrentInstances do elemento serviceThrottling do arquivo de configuração associado ao escopo especificado pelos parâmetros de escopo. Se o elemento serviceThrottling não existir, o cmdlet criará o elemento e definirá os valores.

Você pode usar os parâmetros de escopo e os parâmetros de piping definidos no final desse tópico. Os seguintes parâmetros de limite máximo também podem ser usados com esse cmdlet para definir os valores dos atributos maxConcurrentCalls, maxConcurrentSessions e maxConcurrentInstances no elemento serviceThrottling do arquivo de configuração associado ao escopo especificado. Você precisará passar apenas os parâmetros que deseja alterar. Por exemplo, se você quiser alterar o valor do parâmetro Máximo de Chamadas Simultâneas, bastará passar o parâmetro MaxConcurrentCalls com o valor adequado definido.

Parâmetros de limite máximo

Item	Descrição
MaxConcurrentCalls	Especifica o limite no número de mensagens que um host de serviço pode processar de uma vez. Se o número de chamadas em processamento for igual a esse valor, qualquer nova chamada será colocada na fila até que uma das chamadas ativas esteja concluída. Os valores permitidos para esse intervalo de parâmetro são de 0 até Int32.MaxValue. Configurar esse parâmetro para 0 equivale a configurá-lo para Int32.MaxValue.
MaxConcurrentInstances	Especifica o limite no número de instâncias que um host de serviço pode executar de uma vez. Se o número de instâncias em execução for igual a esse valor, qualquer solicitação para criar instâncias adicionais será colocada na fila e concluída quando uma das instâncias em execução estiver concluída. Os valores permitidos para esse intervalo de parâmetro são de 1 a Int32.MaxValue.
MaxConcurrentSessions	Especifica o limite no número de sessões que um host de serviço pode aceitar. O host de serviço aceitará conexões além do limite, mas somente os canais abaixo do limite estarão ativos (mensagens serão lidas pelo canal). Os valores permitidos para esse intervalo de parâmetro são de 0 até Int32.MaxValue. Configurar este valor para 0 equivale a configurá-lo para Int32.MaxValue.

Para obter informações detalhadas sobre parâmetros de escopo (-SiteName, -VirtualPath, -Uri, etc.), consulte Escopo do cmdlet e para obter informações detalhadas sobre parâmetros de pipe (ApplicationInfo e ServiceInfo), consulte Pipe de cmdlet.

Opções de sintaxe para o cmdlet Set-ASAppServiceThrottling


// 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

Partilhar via