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

Set-AzIotHub

更新 IotHub 的属性。

语法

Set-AzIotHub
   -ResourceGroupName <String>
   -Name <String>
   -SkuName <PSIotHubSku>
   [-Units <Int64>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzIotHub
   -ResourceGroupName <String>
   -Name <String>
   -EventHubRetentionTimeInDays <Int64>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzIotHub
   -ResourceGroupName <String>
   -Name <String>
   [-FileUploadStorageConnectionString <String>]
   [-FileUploadContainerName <String>]
   [-FileUploadSasUriTtl <TimeSpan>]
   [-FileUploadNotificationTtl <TimeSpan>]
   [-FileUploadNotificationMaxDeliveryCount <Int32>]
   -EnableFileUploadNotifications <Boolean>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzIotHub
   -ResourceGroupName <String>
   -Name <String>
   -CloudToDevice <PSCloudToDeviceProperties>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzIotHub
   -ResourceGroupName <String>
   -Name <String>
   [-RoutingProperties <PSRoutingProperties>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzIotHub
   -ResourceGroupName <String>
   -Name <String>
   [-Routes <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Management.IotHub.Models.PSRouteMetadata]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzIotHub
   -ResourceGroupName <String>
   -Name <String>
   [-FallbackRoute <PSFallbackRouteMetadata>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

更新 IotHub 的属性。

示例

示例 1 更新 SKU

Set-AzIotHub -ResourceGroupName "myresourcegroup" -Name "myiothub" -SkuName S1 -Units 5

将 SKU 更新为 S1,将名为“myiothub”的 IotHub 的单位更新为 5

示例 2 更新 eventhub 属性

Set-AzIotHub -ResourceGroupName "myresourcegroup" -Name "myiothub" -EventHubRetentionTimeInDays 4

将名为“myiothub”的 IotHub 的遥测保留时间(以天为单位)更新为 4

参数

-CloudToDevice

云到设备命令队列的属性。

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

-Confirm

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

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

-DefaultProfile

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

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

-EnableFileUploadNotifications

指定是否应为文件上传启用通知的标志。

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

-EventHubRetentionTimeInDays

保留时间(以天为单位)。

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

-FallbackRoute

路由的回退路由

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

-FileUploadContainerName

要将文件上传到的容器的名称。

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

-FileUploadNotificationMaxDeliveryCount

文件上传通知的最大传递计数。

类型:Nullable<T>[Int32]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FileUploadNotificationTtl

文件上传通知队列中消息的生存时间值。

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

-FileUploadSasUriTtl

为文件上传生成的 SAS URI 生存时间。

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

-FileUploadStorageConnectionString

要将文件上传到的存储连接字符串。

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

-Name

IotHub 的名称

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

-ResourceGroupName

资源组名称

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

-Routes

要为路由添加的路由

类型:List<T>[PSRouteMetadata]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RoutingProperties

将消息路由到外部终结点的路由属性

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

-SkuName

Sku 的名称。

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

-Units

服务数量

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

-WhatIf

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

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

输入

String

输出

PSIotHub