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

New-AzIotHub

创建新的 IotHub。

语法

New-AzIotHub
   -ResourceGroupName <String>
   -Name <String>
   -SkuName <PSIotHubSku>
   -Units <Int64>
   -Location <String>
   [-Properties <PSIotHubInputProperties>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

创建新的 IotHub。 可以使用默认属性创建 IotHub,也可以指定输入属性。

示例

示例 1 使用默认属性创建新的 IotHub

$tags = @{}
$tags.Add('key1','value1')
New-AzIotHub -ResourceGroupName "myresourcegroup" -Name "myiothub" -SkuName "S1" -Units 1 -Location "northeurope" -Tag $tags

创建 SKU“S1”的名为“myiothub”的新 IotHub,容量 1 和位置“northeurope”包含在 Tags 中。

示例 2 使用 CloudToDevice 队列的 MaxDeliveryCount 设置为 20 创建新的 IotHub

New-AzIotHub -ResourceGroupName "myresourcegroup" -Name "myiothub" -SkuName "S1" -Units 1 -Location "northeurope" -Properties $properties

使用$properties表示的高级输入属性创建 SKU“S1”、容量 1 和位置“northeurope”的新 IotHub,名为“myiothub”。 $psCloudToDeviceProperties = New-Object Microsoft.Azure.Commands.Management.IotHub.Models.PSCloudToDeviceProperties -Property @{MaxDeliveryCount=20} $properties = New-Object Microsoft.Azure.Commands.Management.IotHub.Models.PSIotHubInputProperties -Property @{CloudToDevice=$psCloudToDeviceProperties} New-AzIotHub -ResourceGroupName “myresourcegroup” -Name “myiothub” -SkuName “S1” -Units 1 -Location “northeurope” -Properties $properties

参数

-Confirm

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

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

-DefaultProfile

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

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

-Location

需要创建 IoT 中心的位置。

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

-Name

IotHub 的名称

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

-Properties

IoT 中心的属性。

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

-ResourceGroupName

资源组名称

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

-SkuName

SKU 的名称

类型:PSIotHubSku
接受的值:F1, S1, S2, S3, B1, B2, B3
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Tag

IoT 中心实例标记。 键值对中的属性包,格式为哈希表。

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

-Units

单位数量

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

-WhatIf

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

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

输入

String

输出

PSIotHub