Freigeben über


Invoke-AzIotHubDeploymentMetricsQuery

Rufen Sie eine IoT Edge-Bereitstellungsmetrikabfrage auf.

Syntax

Invoke-AzIotHubDeploymentMetricsQuery
      [-ResourceGroupName] <String>
      [-IotHubName] <String>
      -Name <String>
      -MetricName <String>
      [-MetricType <PSConfigurationMetricType>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-AzIotHubDeploymentMetricsQuery
      [-InputObject] <PSIotHub>
      -Name <String>
      -MetricName <String>
      [-MetricType <PSConfigurationMetricType>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-AzIotHubDeploymentMetricsQuery
      [-ResourceId] <String>
      -Name <String>
      -MetricName <String>
      [-MetricType <PSConfigurationMetricType>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Bewerten einer benutzerdefinierten Ziel- oder Systemmetrik, die in einer IoT Edge-Bereitstellung definiert ist. Es gibt vordefinierte Systemmetriken, die von Iot Hub berechnet werden und nicht angepasst werden können.

  • "Gezielt" zeigt die IoT Edge-Geräte an, die der Bedingung für die Bereitstellungsadressierung entsprechen.
  • "Angewendet" zeigt die zielbezogenen IoT Edge-Geräte an, die nicht auf eine andere Bereitstellung mit höherer Priorität ausgerichtet sind.
  • "Reporting Success" zeigt die IoT Edge-Geräte an, die gemeldet haben, dass die Module erfolgreich bereitgestellt wurden.
  • "Berichtsfehler" zeigt die IoT Edge-Geräte an, die gemeldet haben, dass mindestens ein Modul nicht erfolgreich bereitgestellt wurde. Um den Fehler weiter zu untersuchen, stellen Sie eine Remoteverbindung mit diesen Geräten her, und zeigen Sie die Protokolldateien an.

Beispiele

Beispiel 1

Invoke-AzIotHubDeploymentMetricsQuery -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -Name "myDeploy1" -MetricName "warningLimit"

Wertet die benutzerdefinierte definierte Metrik "warningLimit" aus.

Beispiel 2

Invoke-AzIotHubDeploymentMetricsQuery -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -Name "myDeploy1" -MetricName "Reporting Success" -MetricType "system"

Wertet die Metrik "Reporting Success" des Systems aus.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

IotHub-Objekt

Typ:PSIotHub
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-IotHubName

Name des Iot Hub

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MetricName

Zielmetrik für die Auswertung.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MetricType

Gibt an, welche Metriksammlung zum Nachschlagen einer Metrik verwendet werden soll.

Typ:PSConfigurationMetricType
Zulässige Werte:Custom, System
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Bezeichner für die Bereitstellung.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Name der Ressourcengruppe

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceId

IotHub-Ressourcen-ID

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSIotHub

String

Ausgaben

PSConfigurationMetricsResult