Partager via

Get-AzBatchPoolUsageMetric

  • Référence
Module:
Az.Batch

Obtient les métriques d’utilisation du pool pour un compte Batch.

Syntaxe

Get-AzBatchPoolUsageMetric
   [-StartTime <DateTime>]
   [-EndTime <DateTime>]
   [-Filter <String>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzBatchPoolUsageMetric obtient les métriques d’utilisation, agrégées par pool à intervalles de temps individuels, pour le compte spécifié. Vous pouvez obtenir les statistiques d’un pool spécifique et d’un intervalle de temps.

Exemples

Exemple 1 : Obtenir les métriques d’utilisation du pool pour un intervalle de temps

$Context = Get-AzBatchAccountKey -AccountName "ContosoBatchAccount"
$StartTime = Get-Date -Date "2016-05-16 00:00:00Z"
$EndTime = Get-Date -Date "2016-05-16 01:00:00Z"
Get-AzBatchPoolUsageMetric -StartTime $StartTime -EndTime $EndTime -BatchContext $context

DataEgressGiB      : 6.68875873088837E-06
DataIngressGiB     : 1.9485130906105E-05
EndTime            : 5/16/2016 12:30:00 AM
PoolId             : testpool1
StartTime          : 5/16/2016 12:00:00 AM
TotalCoreHours     : 8
VirtualMachineSize : standard_d4

DataEgressGiB      : 5.61587512493134E-06
DataIngressGiB     : 1.76150351762772E-05
EndTime            : 5/16/2016 12:30:00 AM
PoolId             : testpool2
StartTime          : 5/16/2016 12:00:00 AM
TotalCoreHours     : 12
VirtualMachineSize : standard_d4

DataEgressGiB      : 7.36676156520844E-06
DataIngressGiB     : 2.10804864764214E-05
EndTime            : 5/16/2016 1:00:00 AM
PoolId             : testpool1
StartTime          : 5/16/2016 12:30:00 AM
TotalCoreHours     : 7.99999999955555
VirtualMachineSize : standard_d4

DataEgressGiB      : 5.80586493015289E-06
DataIngressGiB     : 1.80602073669434E-05
EndTime            : 5/16/2016 1:00:00 AM
PoolId             : testpool2
StartTime          : 5/16/2016 12:30:00 AM
TotalCoreHours     : 11.9999999993333
VirtualMachineSize : standard_d4

La première commande crée une référence d’objet aux clés de compte pour le compte batch nommé ContosoBatchAccount à l’aide de Get-AzBatchAccountKey. La commande stocke cette référence d’objet dans la variable $Context. Les deux commandes suivantes créent des objets DateTime à l’aide de l’applet de commande Get-Date. Les commandes stockent ces valeurs dans les variables $StartTime et $EndTime à utiliser avec la commande finale. La commande finale retourne toutes les métriques d’utilisation du pool, agrégées par pool, entre l’intervalle de temps entre les heures de début et de fin spécifiées.

Exemple 2 : Obtenir des métriques d’utilisation du pool à l’aide d’un filtre

Get-AzBatchPoolUsageMetric -Filter "poolId eq 'ContosoPool'" -BatchContext $Context

DataEgressGiB      : 9.0496614575386E-06
DataIngressGiB     : 2.60043889284134E-05
EndTime            : 5/16/2016 5:30:00 PM
PoolId             : MyPool
StartTime          : 5/16/2016 5:00:00 PM
TotalCoreHours     : 12
VirtualMachineSize : standard_d4

Cette commande retourne les métriques d’utilisation pour le pool nommé ContosoPool. La commande spécifie une chaîne de filtre pour spécifier ce pool et utilise la même valeur $Context que l’exemple précédent.

Paramètres

-BatchContext

Spécifie l’instance BatchAccountContext utilisée par cette applet de commande pour interagir avec le service Batch. Si vous utilisez l’applet de commande Get-AzBatchAccount pour obtenir votre BatchAccountContext, l’authentification Microsoft Entra sera utilisée lors de l’interaction avec le service Batch. Pour utiliser l’authentification par clé partagée à la place, utilisez l’applet de commande Get-AzBatchAccountKey pour obtenir un objet BatchAccountContext avec ses clés d’accès remplies. Lorsque vous utilisez l’authentification par clé partagée, la clé d’accès primaire est utilisée par défaut. Pour modifier la clé à utiliser, définissez la propriété BatchAccountContext.KeyInUse.

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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EndTime

Spécifie la fin d’une plage de temps pour laquelle cette applet de commande obtient les métriques d’utilisation. Spécifiez une heure au moins deux heures plus tôt. Si vous ne spécifiez pas d’heure de fin, cette applet de commande utilise le dernier intervalle d’agrégation actuellement disponible.

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

-Filter

Spécifie une clause de filtre OData à utiliser pour filtrer les métriques retournées par cette applet de commande. La seule propriété valide est poolId avec une valeur de chaîne. Les opérations possibles sont les suivantes : eq, ge, gt, le, lt, startswith.

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

-StartTime

Spécifie le début d’un intervalle de temps pour lequel cette applet de commande obtient les métriques d’utilisation. Spécifiez une heure au moins deux heures et demi plus tôt. Si vous ne spécifiez pas d’heure de début, cette applet de commande utilise le dernier intervalle d’agrégation actuellement disponible.

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

Entrées

BatchAccountContext

Sorties

PSPoolUsageMetrics