你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-AzMetricsBatch

列出多个资源的指标值。

语法

BatchExpanded (默认值)

Get-AzMetricsBatch
    -Endpoint <String>
    -Name <System.Collections.Generic.List`1[System.String]>
    -Namespace <String>
    [-SubscriptionId <String[]>]
    [-Aggregation <String>]
    [-EndTime <String>]
    [-Filter <String>]
    [-Interval <String>]
    [-Orderby <String>]
    [-Rollupby <String>]
    [-StartTime <String>]
    [-Top <Int32>]
    [-ResourceId <String[]>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BatchViaIdentityExpanded

Get-AzMetricsBatch
    -Endpoint <String>
    -InputObject <IMetricdataIdentity>
    -Name <System.Collections.Generic.List`1[System.String]>
    -Namespace <String>
    [-Aggregation <String>]
    [-EndTime <String>]
    [-Filter <String>]
    [-Interval <String>]
    [-Orderby <String>]
    [-Rollupby <String>]
    [-StartTime <String>]
    [-Top <Int32>]
    [-ResourceId <String[]>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

列出多个资源的指标值。

示例

示例 1:从存储帐户获取入口和出口

$endpoint = 'https://eastus.metrics.monitor.azure.com'
$start = "2023-12-06T07:00:00.000Z"
$end = "2023-12-06T08:00:00.000Z"
Get-AzMetricsBatch -Endpoint $endpoint -Name 'ingress','egress' -Namespace "Microsoft.Storage/storageAccounts" -EndTime $end -StartTime $start -ResourceId '/subscriptions/{subid}/resourcegroups/{groupname}/providers/Microsoft.Storage/storageAccounts/{account}'
Endtime        : 2023-12-06T08:00:00Z
Interval       : 00:01:00a
Namespace      : Microsoft.Storage/storageAccounts
Resourceid     : /subscriptions/subid/resourcegroups/groupname/providers/Microsoft.Storage/storageAccounts/account
Resourceregion : eastus
Starttime      : 2023-12-06T07:00:00Z
Value          : {{
                   "name": {
                     "value": "Ingress",
                     "localizedValue": "Ingress"
                   },
                   "id": "/subscriptions/subid/resourcegroups/groupname/providers/Microsoft.Storage/storageAccounts/account/providers/Microsoft.Insights/metrics/Ingress",
                   "type": "Microsoft.Insights/metrics",
                   "displayDescription": "The amount of ingress data, in bytes. This number includes ingress from an external client into Azure Storage as well as ingress within Azure.",
                   "errorCode": "Success",
                   "unit": "Bytes",
                   "timeseries": [
                     {
                       "metadatavalues": [ ],
                       "data": [
                         {
                           "timeStamp": "2023-12-06T07:00:00.0000000Z",
                           "total": 0
                         },
                         {
                           "timeStamp": "2023-12-06T07:01:00.0000000Z",
                           "total": 0
                         },
                         {
                           "timeStamp": "2023-12-06T07:59:00.0000000Z",
                           "total": 0
                         }
                       ]
                     }
                   ]
                 }, {
                   "name": {
                     "value": "Egress",
                     "localizedValue": "Egress"
                   },
                   "id": "/subscriptions/subid/resourcegroups/groupname/providers/Microsoft.Storage/storageAccounts/account/providers/Microsoft.Insights/metrics/Egress",
                   "type": "Microsoft.Insights/metrics",
                   "displayDescription": "The amount of egress data. This number includes egress to external client from Azure Storage as well as egress within Azure. As a result, this
                 number does not reflect billable egress.",
                   "errorCode": "Success",
                   "unit": "Bytes",
                   "timeseries": [
                     {
                       "metadatavalues": [ ],
                       "data": [
                         {
                           "timeStamp": "2023-12-06T07:00:00.0000000Z",
                           "total": 0
                         },
                         {
                           "timeStamp": "2023-12-06T07:01:00.0000000Z",
                           "total": 0
                         },
                         {
                           "timeStamp": "2023-12-06T07:59:00.0000000Z",
                           "total": 0
                         }
                       ]
                     }
                   ]
                 }}

此命令列出指定资源的指标值。 长时序的已删除数据示例。

参数

-Aggregation

要检索的聚合类型列表(逗号分隔)。 示例:平均值、最小值、最大值

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

在运行 cmdlet 之前,提示你进行确认。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

DefaultProfile 参数不起作用。 如果对其他订阅执行 cmdlet,请使用 SubscriptionId 参数。

参数属性

类型:PSObject
默认值:None
支持通配符:False
不显示:False
别名:AzureRMContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Endpoint

要使用的区域终结点,例如 https://eastus.metrics.monitor.azure.com。 该区域应与请求的资源区域匹配。 对于全局资源,区域应为“全局”。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EndTime

查询的结束时间。 它是格式为“yyyy-MM-ddTHH:mm:ss.fffZ”的字符串。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Filter

该筛选器用于减少返回的指标数据集。 示例:指标包含元数据 A、B 和 C。

  • 返回 C 的所有时序,其中 A = a1 和 B = b1 或 b2 filter=A eq 'a1' 和 B eq 'b1' 或 B eq 'b2' 和 C eq '*'
  • 无效变体: filter=A eq “a1” 和 B eq 'b1' 和 C eq '*' 或 B = 'b2' 这是无效的,因为逻辑或运算符不能分隔两个不同的元数据名称。
  • 返回所有时序,其中 A = a1,B = b1 和 C = c1:filter=A eq 'a1' 和 B eq 'b1' 和 C eq 'c1'
  • 返回所有时序,其中 A = a1 filter=A eq 'a1' 和 B eq '' 和 C eq ''

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InputObject

标识参数

参数属性

类型:IMetricdataIdentity
默认值:None
支持通配符:False
不显示:False

参数集

BatchViaIdentityExpanded
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Interval

查询的间隔(即时间根)采用 ISO 8601 持续时间格式。 默认为 PT1M。 “FULL”值的特殊情况,该值返回所请求的整个时间跨度的单个数据点。 示例:PT15M、PT1H、P1D、FULL

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

要检索的指标的名称(逗号分隔)。

参数属性

类型:

List<T>[String]

默认值:None
支持通配符:False
不显示:False
别名:指标名称

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Namespace

包含请求的指标名称的指标命名空间。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:MetricNamespace

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Orderby

用于对结果进行排序和排序方向的聚合。 只能指定一个订单。 示例:sum asc

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceId

要查询其指标的资源 ID 的列表。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Rollupby

要汇总结果的维度名称(s)。 例如,如果只想查看带有“City eq Seattle 或 City eq Tacoma”等筛选器的指标值,但不想查看每个城市的单独值,则可以指定“RollUpBy=City”以查看西雅图的结果,Tacoma 汇总为一次。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-StartTime

查询的开始时间。 它是格式为“yyyy-MM-ddTHH:mm:ss.fffZ”的字符串。 如果指定了 endtime 参数,则需要此参数。 如果仅指定 starttime,则结束时间默认为当前时间。 如果未指定时间间隔,则默认值为 1 小时。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SubscriptionId

此批中资源的订阅标识符。

参数属性

类型:

String[]

默认值:(Get-AzContext).Subscription.Id
支持通配符:False
不显示:False

参数集

BatchExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Top

要检索请求中每个资源 ID 的最大记录数。 仅当指定筛选器时才有效。 默认值为 10。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

IMetricdataIdentity

输出

IMetricResultsResponse