Configuration de la limitation à l'aide des cmdlets d'AppFabric

Article
03/05/2012

Cette rubrique décrit l'obtention et la définition des valeurs des paramètres de limitation à l'aide des cmdlets de AppFabric.

Notes

Pour exécuter une cmdlet de AppFabric de manière interactive, vous devez utiliser la console Windows PowerShell pour Microsoft AppFabric 1.1 pour Windows Server, entrer la cmdlet appropriée, puis appuyer sur Entrée. Pour plus d'informations sur l'exécution des cmdlets de AppFabric, consultez la rubrique Exécution des cmdlets d'AppFabric.

Obtention des paramètres de limitation à l'aide de cmdlets

Dans la console Windows PowerShell de AppFabric, exécutez la cmdlet Get-ASAppServiceThrottling pour obtenir les valeurs des paramètres de limitation. Cette cmdlet récupère les valeurs des attributs maxConcurrentCalls, maxConcurrentSessions etmaxConcurrentInstances de l'élément serviceThrottling dans le fichier de configuration associé à l'étendue spécifiée par les paramètres d'étendue.

La liste suivante indique les différentes syntaxes qui peuvent être utilisées avec cette cmdlet. Pour plus d'informations sur les paramètres d'étendue (-SiteName, -VirtualPath, -Uri, etc.), consultez la rubrique Étendue des cmdlets. Pour plus d'informations sur les paramètres de chaînage (ApplicationInfo et ServiceInfo), consultez la rubrique Chaînage des cmdlets.

Options de syntaxe de la 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

Définition des paramètres de limitation à l'aide de cmdlets

Dans la console Windows PowerShell de AppFabric, exécutez la cmdlet Set-ASAppServiceThrottling pour définir les valeurs des paramètres de limitation. Cette cmdlet définit les valeurs des attributs maxConcurrentCalls, maxConcurrentSessions et maxConcurrentInstances de l'élément serviceThrottling dans le fichier de configuration associé à l'étendue spécifiée par les paramètres d'étendue. Si l'élément serviceThrottling n'existe pas, la cmdlet crée l'élément, puis définit les valeurs.

Vous pouvez utiliser les paramètres d'étendue et les paramètres de chaînage définis à la fin de cette rubrique. Vous pouvez également utiliser les paramètres de limitation suivants avec cette cmdlet pour définir les valeurs des attributs maxConcurrentCalls, maxConcurrentSessions et maxConcurrentInstances de l'élément serviceThrottling dans le fichier de configuration associé à l'étendue spécifiée. Vous devez uniquement transmettre les paramètres que vous voulez modifier. Par exemple, si vous voulez modifier la valeur du paramètre Nombre maximal d'appels simultanés, transmettez seulement le paramètre MaxConcurrentCalls avec la valeur appropriée définie.

Paramètres de limitation

Option	Description :
MaxConcurrentCalls	Spécifie le nombre maximal de messages qu'un hôte de service peut traiter simultanément. Si le nombre d'appels traités correspond à cette valeur, les nouveaux appels sont placés en file d'attente jusqu'à la fin d'un des appels actifs. Les valeurs autorisées pour ce paramètre sont comprises entre 0 et Int32.MaxValue. La définition de ce paramètre sur 0 revient à le définir sur Int32.MaxValue.
MaxConcurrentInstances	Spécifie le nombre maximal d'instances qu'un hôte de service peut exécuter simultanément. Si le nombre d'instances en cours d'exécution correspond à cette valeur, les demandes de création d'instances supplémentaires sont placées en file d'attente et exécutées lorsque le traitement d'une des instances en cours d'exécution est terminé. Les valeurs autorisées pour ce paramètre sont comprises entre 1 et Int32.MaxValue.
MaxConcurrentSessions	Spécifie le nombre maximal de sessions qu'un hôte de service peut accepter. L'hôte de service accepte les connexions au-delà de cette limite, mais seuls les canaux inférieurs à la limite sont actifs (les messages sont lus à partir du canal). Les valeurs autorisées pour ce paramètre sont comprises entre 0 et Int32.MaxValue. La définition de cette valeur sur 0 revient à la définir sur Int32.MaxValue.

Pour plus d'informations sur les paramètres d'étendue (-SiteName, -VirtualPath, -Uri, etc.), consultez la rubrique Étendue des cmdlets. Pour plus d'informations sur les paramètres de chaînage (ApplicationInfo et ServiceInfo), consultez la rubrique Chaînage des cmdlets.

Options de syntaxe de la 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

2012-03-05

Partage via