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

Add-AzIotHubRoutingEndpoint

将终结点添加到IoT 中心

语法

Add-AzIotHubRoutingEndpoint
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-EndpointName] <String>
   -EndpointType <PSEndpointType>
   -EndpointResourceGroup <String>
   -EndpointSubscriptionId <String>
   -ConnectionString <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzIotHubRoutingEndpoint
   [-InputObject] <PSIotHub>
   [-EndpointName] <String>
   -EndpointType <PSEndpointType>
   -EndpointResourceGroup <String>
   -EndpointSubscriptionId <String>
   -ConnectionString <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzIotHubRoutingEndpoint
   [-ResourceId] <String>
   [-EndpointName] <String>
   -EndpointType <PSEndpointType>
   -EndpointResourceGroup <String>
   -EndpointSubscriptionId <String>
   -ConnectionString <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

在IoT 中心添加新终结点。 若要了解支持的终结点,请参阅 https://learn.microsoft.com/azure/iot-hub/iot-hub-devguide-endpoints

示例

示例 1

Add-AzIotHubRoutingEndpoint -ResourceGroupName "myresourcegroup" -Name "myiothub" -EndpointName E2 -EndpointType EventHub -EndpointResourceGroup resourcegroup1 -EndpointSubscriptionId 91d12343-a3de-345d-b2ea-135792468abc -ConnectionString 'Endpoint=sb://myeventhub1.servicebus.windows.net/;SharedAccessKeyName=access1;SharedAccessKey=*****=;EntityPath=event11'

ResourceGroupName : resourcegroup1
SubscriptionId    : 91d12343-a3de-345d-b2ea-135792468abc
EndpointName      : E2
ConnectionString  : Endpoint=sb://myeventhub1.servicebus.windows.net:5671/;SharedAccessKeyName=iothubroutes_myeventhub1;SharedAccessKey=****;EntityPath=event1

将 EventHub 类型的新终结点“E2”添加到“myiothub”IoT 中心。

示例 2

Add-AzIotHubRoutingEndpoint -ResourceGroupName "myresourcegroup" -Name "myiothub" -EndpointName S1 -EndpointType AzureStorageContainer -EndpointResourceGroup resourcegroup1 -EndpointSubscriptionId 91d12343-a3de-345d-b2ea-135792468abc -ConnectionString 'DefaultEndpointsProtocol=https;AccountName=mystorage1;AccountKey=*****;EndpointSuffix=core.windows.net' -ContainerName container -Encoding json

ResourceGroupName       : resourcegroup1
SubscriptionId          : 91d12343-a3de-345d-b2ea-135792468abc
EndpointName            : S1
ContainerName           : container
ConnectionString        : DefaultEndpointsProtocol=https;EndpointSuffix=core.windows.net;AccountName=mystorage1;AccountKey=****
FileNameFormat          : {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}
BatchFrequencyInSeconds : 300
MaxChunkSizeInBytes     : 314572800
Encoding                : json

将 AzureStorageContainer 类型的新终结点“S1”添加到“myiothub”IoT 中心。

参数

-Confirm

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

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ConnectionString

路由终结点的连接字符串

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ContainerName

存储容器的名称

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Encoding

选择要在其中路由数据的格式。 可以选择 JSON 或 AVRO。 默认值设置为 AVRO。

类型:String
接受的值:JSON, AVRO
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EndpointName

路由终结点的名称

类型:String
Position:1
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-EndpointResourceGroup

终结点资源的资源组

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-EndpointSubscriptionId

Endpoint 资源的 SubscriptionId

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-EndpointType

路由终结点的类型

类型:PSEndpointType
接受的值:EventHub, ServiceBusQueue, ServiceBusTopic, AzureStorageContainer
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-InputObject

IotHub 对象

类型:PSIotHub
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

IoT 中心的名称

类型:String
Position:1
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ResourceGroupName

资源组的名称

类型:String
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ResourceId

IotHub 资源 ID

类型:String
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

PSIotHub

String

输出

PSRoutingEventHubEndpoint

PSRoutingServiceBusQueueEndpoint

PSRoutingServiceBusTopicEndpoint

PSRoutingStorageContainerEndpoint