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

Set-AzIotHub

更新 IotHub 的属性。

语法

UpdateSku (默认值)

Set-AzIotHub
    -ResourceGroupName <String>
    -Name <String>
    -SkuName <PSIotHubSku>
    [-Units <Int64>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateEventHubEndpointProperties

Set-AzIotHub
    -ResourceGroupName <String>
    -Name <String>
    -EventHubRetentionTimeInDays <Int64>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateFileUploadProperties

Set-AzIotHub
    -ResourceGroupName <String>
    -Name <String>
    -EnableFileUploadNotifications <Boolean>
    [-FileUploadStorageConnectionString <String>]
    [-FileUploadContainerName <String>]
    [-FileUploadSasUriTtl <TimeSpan>]
    [-FileUploadNotificationTtl <TimeSpan>]
    [-FileUploadNotificationMaxDeliveryCount <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateCloudToDeviceProperties

Set-AzIotHub
    -ResourceGroupName <String>
    -Name <String>
    -CloudToDevice <PSCloudToDeviceProperties>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateRoutingProperties

Set-AzIotHub
    -ResourceGroupName <String>
    -Name <String>
    [-RoutingProperties <PSRoutingProperties>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateRouteProperties

Set-AzIotHub
    -ResourceGroupName <String>
    -Name <String>
    [-Routes <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Management.IotHub.Models.PSRouteMetadata]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateFallbackRouteProperty

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
默认值:None
支持通配符:False
不显示:False

参数集

UpdateCloudToDeviceProperties
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

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

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

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

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EnableFileUploadNotifications

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

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

UpdateFileUploadProperties
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EventHubRetentionTimeInDays

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

参数属性

类型:Int64
默认值:None
支持通配符:False
不显示:False

参数集

UpdateEventHubEndpointProperties
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-FallbackRoute

路由的回退路由

参数属性

类型:PSFallbackRouteMetadata
默认值:None
支持通配符:False
不显示:False

参数集

UpdateFallbackRouteProperty
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-FileUploadContainerName

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UpdateFileUploadProperties
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-FileUploadNotificationMaxDeliveryCount

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

参数属性

类型:

Nullable<T>[Int32]

默认值:None
支持通配符:False
不显示:False

参数集

UpdateFileUploadProperties
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-FileUploadNotificationTtl

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

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

UpdateFileUploadProperties
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-FileUploadSasUriTtl

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

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

UpdateFileUploadProperties
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-FileUploadStorageConnectionString

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UpdateFileUploadProperties
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

IotHub 的名称

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ResourceGroupName

资源组名称

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Routes

要为路由添加的路由

参数属性

类型:

List<T>[PSRouteMetadata]

默认值:None
支持通配符:False
不显示:False

参数集

UpdateRouteProperties
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RoutingProperties

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

参数属性

类型:PSRoutingProperties
默认值:None
支持通配符:False
不显示:False

参数集

UpdateRoutingProperties
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SkuName

Sku 的名称。

参数属性

类型:PSIotHubSku
默认值:None
接受的值:F1, S1, S2, S3, B1, B2, B3
支持通配符:False
不显示:False

参数集

UpdateSku
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Units

单位数

参数属性

类型:Int64
默认值:None
支持通配符:False
不显示:False

参数集

UpdateSku
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符: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

输入

String

输出

PSIotHub