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

Update-AzIoTDeviceProvisioningService

更新 Azure IoT 中心设备预配服务。

语法

Update-AzIoTDeviceProvisioningService
      [-ResourceGroupName] <String>
      [-Name] <String>
      [-Tag] <Hashtable>
      [-Reset]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzIoTDeviceProvisioningService
      [-InputObject] <PSProvisioningServiceDescription>
      [-Tag] <Hashtable>
      [-Reset]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzIoTDeviceProvisioningService
      [-InputObject] <PSProvisioningServiceDescription>
      [-AllocationPolicy] <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzIoTDeviceProvisioningService
      [-ResourceId] <String>
      [-Tag] <Hashtable>
      [-Reset]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzIoTDeviceProvisioningService
      [-ResourceId] <String>
      [-AllocationPolicy] <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzIoTDeviceProvisioningService
      [-ResourceGroupName] <String>
      [-Name] <String>
      [-AllocationPolicy] <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

有关 Azure IoT 中心设备预配服务的简介,请参阅 https://learn.microsoft.com/azure/iot-dps/about-iot-dps

示例

示例 1

Update-AzIoTDeviceProvisioningService -ResourceGroupName "myresourcegroup" -Name "myiotdps" -AllocationPolicy "GeoLatency"

ResourceGroupName			: myresourcegroup
Name						: myiotdps
Type						: Microsoft.Devices/provisioningServices
ServiceOperationsHostName	: myiotdps.azure-devices-provisioning.net
IotHubs						: 0
State						: Active
AllocationPolicy			: GeoLatency
Tags						: {}
SkuName						: S1
SkuTier						: Standard
Etag						: AAAAAAAT52k=

将分配策略更新为 Azure IoT 中心设备预配服务“myiotdps”的“GeoLatency”。

示例 2

$tag = @{}
$tag.Add("key1","Value1")
Update-AzIoTDeviceProvisioningService -ResourceGroupName "myresourcegroup" -Name "myiotdps" -Tag $tag

ResourceGroupName			: myresourcegroup
Name						: myiotdps
Type						: Microsoft.Devices/provisioningServices
ServiceOperationsHostName	: myiotdps.azure-devices-provisioning.net
IotHubs						: 0
State						: Active
AllocationPolicy			: Hashed
Tags						: {['key1','Value1']}
SkuName						: S1
SkuTier						: Standard
Etag						: AAAAAAAPoOk=

将标记添加到 Azure IoT 中心设备预配服务“myiotdps”。

示例 3

$tag = @{}
$tag.Add("key1","Value1")
Get-AzIoTDeviceProvisioningService -ResourceGroupName "myresourcegroup" -Name "myiotdps" | Update-AzIoTDeviceProvisioningService -Tag $tag -Reset

ResourceGroupName			: myresourcegroup
Name						: myiotdps
Type						: Microsoft.Devices/provisioningServices
ServiceOperationsHostName	: myiotdps.azure-devices-provisioning.net
IotHubs						: 0
State						: Active
AllocationPolicy			: Hashed
Tags						: {['key1','Value1']}
SkuName						: S1
SkuTier						: Standard
Etag						: AAAAAAAS1dY=

删除标记,并使用管道将新标记添加到 Azure IoT 中心设备预配服务“myiotdps”。

参数

-AllocationPolicy

IoT 设备预配服务分配策略

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

-Confirm

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

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

-DefaultProfile

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

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

-InputObject

IoT 设备预配服务对象

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

-Name

IoT 设备预配服务的名称

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

-Reset

重置 IoT 设备预配服务标记

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

-ResourceGroupName

资源组的名称

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

-ResourceId

IoT 设备预配服务资源 ID

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

-Tag

IoT 设备预配服务标记集合

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

-WhatIf

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

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

输入

输出