New-AzAutoscaleScaleRuleObject

Créez un objet en mémoire pour ScaleRule.

Syntaxe

New-AzAutoscaleScaleRuleObject
   -MetricTriggerMetricName <String>
   -MetricTriggerMetricResourceUri <String>
   -MetricTriggerOperator <ComparisonOperationType>
   -MetricTriggerStatistic <MetricStatisticType>
   -MetricTriggerThreshold <Double>
   -MetricTriggerTimeAggregation <TimeAggregationType>
   -MetricTriggerTimeGrain <TimeSpan>
   -MetricTriggerTimeWindow <TimeSpan>
   -ScaleActionCooldown <TimeSpan>
   -ScaleActionDirection <ScaleDirection>
   -ScaleActionType <ScaleType>
   [-MetricTriggerDimension <IScaleRuleMetricDimension[]>]
   [-MetricTriggerDividePerInstance <Boolean>]
   [-MetricTriggerMetricNamespace <String>]
   [-MetricTriggerMetricResourceLocation <String>]
   [-ScaleActionValue <String>]
   [<CommonParameters>]

Description

Créez un objet en mémoire pour ScaleRule.

Exemples

Exemple 1 : Créer un objet de règle d’échelle

$subscriptionId = (Get-AzContext).Subscription.Id
New-AzAutoscaleScaleRuleObject -MetricTriggerMetricName "Percentage CPU" -MetricTriggerMetricResourceUri "/subscriptions/$subscriptionId/resourceGroups/test-group/providers/Microsoft.Compute/virtualMachineScaleSets/test-vmss" -MetricTriggerTimeGrain ([System.TimeSpan]::New(0,1,0)) -MetricTriggerStatistic "Average" -MetricTriggerTimeWindow ([System.TimeSpan]::New(0,5,0)) -MetricTriggerTimeAggregation "Average" -MetricTriggerOperator "GreaterThan" -MetricTriggerThreshold 10 -MetricTriggerDividePerInstance $false -ScaleActionDirection "Increase" -ScaleActionType "ChangeCount" -ScaleActionValue 1 -ScaleActionCooldown ([System.TimeSpan]::New(0,5,0))

Créer un objet de règle d’échelle

Paramètres

-MetricTriggerDimension

Liste des conditions de dimension. Par exemple : [{"DimensionName » :"AppName »,"Operator » :"Equals »,"Values » :["App1"]},{"DimensionName » :"Deployment »,"Operator » :"Equals »,"Values » :["default"]}]. Pour construire, consultez la section NOTES pour les propriétés METRICTRIGGERDIMENSION et créer une table de hachage.

Type:IScaleRuleMetricDimension[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MetricTriggerDividePerInstance

valeur indiquant si la métrique doit diviser par instance.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MetricTriggerMetricName

nom de la métrique qui définit ce que la règle surveille.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MetricTriggerMetricNamespace

espace de noms de la métrique qui définit ce que la règle surveille.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MetricTriggerMetricResourceLocation

emplacement de la ressource que la règle surveille.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MetricTriggerMetricResourceUri

l’identificateur de ressource de la ressource que la règle surveille.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MetricTriggerOperator

opérateur utilisé pour comparer les données de métrique et le seuil.

Type:ComparisonOperationType
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MetricTriggerStatistic

type de statistique de métrique. Comment les métriques de plusieurs instances sont combinées.

Type:MetricStatisticType
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MetricTriggerThreshold

seuil de la métrique qui déclenche l’action de mise à l’échelle.

Type:Double
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MetricTriggerTimeAggregation

type d’agrégation de temps. Détermine la façon dont les données collectées doivent être combinées au fil du temps. La valeur par défaut est Average.

Type:TimeAggregationType
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MetricTriggerTimeGrain

granularité des métriques que la règle surveille. Doit être l’une des valeurs prédéfinies retournées par les définitions de métriques pour la métrique. Doit être compris entre 12 heures et 1 minute.

Type:TimeSpan
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MetricTriggerTimeWindow

intervalle de temps dans lequel les données d’instance sont collectées. Cette valeur doit être supérieure au délai de collecte de métriques, qui peut varier de la ressource à la ressource. Doit être compris entre 12 heures et 5 minutes.

Type:TimeSpan
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ScaleActionCooldown

durée d’attente depuis la dernière action de mise à l’échelle avant que cette action ne se produise. Il doit être compris entre 1 semaine et 1 minute au format ISO 8601.

Type:TimeSpan
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ScaleActionDirection

direction de l’échelle. Indique si l’action de mise à l’échelle augmente ou diminue le nombre d’instances.

Type:ScaleDirection
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ScaleActionType

type d’action qui doit se produire lorsque la règle de mise à l’échelle se déclenche.

Type:ScaleType
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ScaleActionValue

nombre d’instances impliquées dans l’action de mise à l’échelle. Cette valeur doit être définie sur 1 ou supérieur. La valeur par défaut est 1.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

ScaleRule