Test-AzIotHubRoute

IoT 中樞 中的 Test routes

語法

ResourceSet (預設值)

Test-AzIotHubRoute
    [-Body <String>]
    [-AppProperty <Hashtable>]
    [-SystemProperty <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

InputObjectTestRouteSet

Test-AzIotHubRoute
    [-InputObject] <PSIotHub>
    [-RouteName] <String>
    [-Body <String>]
    [-AppProperty <Hashtable>]
    [-SystemProperty <Hashtable>]
    [-ShowError]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

InputObjectTestAllRouteSet

Test-AzIotHubRoute
    [-InputObject] <PSIotHub>
    [-Source] <PSRoutingSource>
    [-Body <String>]
    [-AppProperty <Hashtable>]
    [-SystemProperty <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

TestRouteSet

Test-AzIotHubRoute
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-RouteName] <String>
    [-Body <String>]
    [-AppProperty <Hashtable>]
    [-SystemProperty <Hashtable>]
    [-ShowError]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

TestAllRouteSet

Test-AzIotHubRoute
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-Source] <PSRoutingSource>
    [-Body <String>]
    [-AppProperty <Hashtable>]
    [-SystemProperty <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ResourceIdTestRouteSet

Test-AzIotHubRoute
    [-ResourceId] <String>
    [-RouteName] <String>
    [-Body <String>]
    [-AppProperty <Hashtable>]
    [-SystemProperty <Hashtable>]
    [-ShowError]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

ResourceIdTestAllRouteSet

Test-AzIotHubRoute
    [-ResourceId] <String>
    [-Source] <PSRoutingSource>
    [-Body <String>]
    [-AppProperty <Hashtable>]
    [-SystemProperty <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

測試特定路線。

範例

範例 1

Test-AzIotHubRoute -ResourceGroupName "myresourcegroup" -Name "myiothub" -Source DeviceMessages
RouteName DataSource     EndpointNames IsEnabled
--------- ----------     ------------- ---------
R1        DeviceMessages events        True
R5        DeviceMessages E1            True

測試所有具有來源「DeviceMessages」的路由。

範例 2

Test-AzIotHubRoute -ResourceGroupName "myresourcegroup" -Name "myiothub" -RouteName R1
Result : true

測試特定路線。

範例 3

Test-AzIotHubRoute -ResourceGroupName "myresourcegroup" -Name "myiothub" -RouteName R1 -ShowError
ErrorMessage  Severity LocationStartLine LocationStartColumn LocationEndLine LocationEndColumn
------------  -------- ----------------- ------------------- --------------- -----------------
Syntax error. error    1                 29                  1               30

測試特定路由並顯示失敗原因。

範例 4

$ap = @{}
$ap.add("key0","value0")
$sp = @{}
$sp.add("key1", "value1")
Test-AzIotHubRoute -ResourceGroupName "myresourcegroup" -Name "myiothub" -RouteName R1 -AppProperty $ap -SystemProperty $sp
Result : true

使用 AppProperty 和 SystemProperty 測試特定路由。

參數

-AppProperty

路由訊息的應用程式屬性

參數屬性

類型:Hashtable
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Body

路由訊息內文

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

用於與 Azure 通訊的憑證、帳號、租戶和訂閱。

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InputObject

IotHub 物件

參數屬性

類型:PSIotHub
預設值:None
支援萬用字元:False
不要顯示:False

參數集

InputObjectTestRouteSet
Position:0
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
InputObjectTestAllRouteSet
Position:0
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

IoT 中樞的名稱

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

TestRouteSet
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
TestAllRouteSet
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResourceGroupName

資源群組的名稱

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

TestRouteSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
TestAllRouteSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResourceId

IotHub 資源識別碼

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

ResourceIdTestRouteSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False
ResourceIdTestAllRouteSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-RouteName

路線名稱

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

InputObjectTestRouteSet
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
TestRouteSet
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
ResourceIdTestRouteSet
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ShowError

顯示詳細錯誤 (如果存在)

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

InputObjectTestRouteSet
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
TestRouteSet
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
ResourceIdTestRouteSet
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Source

路線來源

參數屬性

類型:PSRoutingSource
預設值:None
接受的值:Invalid, DeviceMessages, TwinChangeEvents, DeviceLifecycleEvents, DeviceJobLifecycleEvents, DigitalTwinChangeEvents
支援萬用字元:False
不要顯示:False

參數集

InputObjectTestAllRouteSet
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
TestAllRouteSet
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
ResourceIdTestAllRouteSet
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SystemProperty

路由訊息的系統屬性

參數屬性

類型:Hashtable
預設值: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。

輸入

PSIotHub

String

輸出

PSTestRouteResult

PSRouteCompilationError

PSRouteProperties