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

Set-AzIotHubDistributedTracing

更新设备的分布式跟踪选项。

语法

ResourceSet (默认值)

Set-AzIotHubDistributedTracing
    [-ResourceGroupName] <String>
    [-IotHubName] <String>
    [-DeviceId] <String>
    [-SamplingMode] <PSDistributedTracingSamplingMode>
    [-SamplingRate <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectSet

Set-AzIotHubDistributedTracing
    [-InputObject] <PSIotHub>
    [-DeviceId] <String>
    [-SamplingMode] <PSDistributedTracingSamplingMode>
    [-SamplingRate <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdSet

Set-AzIotHubDistributedTracing
    [-ResourceId] <String>
    [-DeviceId] <String>
    [-SamplingMode] <PSDistributedTracingSamplingMode>
    [-SamplingRate <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

更新设备的分布式跟踪选项。

示例

示例 1

Set-AzIotHubDistributedTracing -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -SamplingMode Enabled -SamplingRate 22
DeviceId      : mydevice1
Sampling Mode : Enabled
Sampling Rate : 22%
IsSynced      : False

更新设备的分布式跟踪选项。

参数

-Confirm

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

参数属性

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

-DeviceId

目标设备 ID。

参数属性

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

参数集

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

-InputObject

IotHub 对象

参数属性

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

参数集

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

-IotHubName

IoT 中心的名称

参数属性

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

参数集

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

-ResourceGroupName

资源组的名称

参数属性

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

参数集

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

-ResourceId

IotHub 资源 ID

参数属性

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

参数集

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

-SamplingMode

为分布式跟踪启用和禁用轮次采样。

参数属性

类型:PSDistributedTracingSamplingMode
默认值:None
接受的值:Disabled, Enabled
支持通配符:False
不显示:False
别名:模式

参数集

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

-SamplingRate

控制为添加跟踪上下文而采样的消息量。 此值是百分比。 仅允许从 0 到 100(含)的值。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False
别名:费率

参数集

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

-WhatIf

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

参数属性

类型:SwitchParameter
默认值: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

输出

PSDeviceTracing