你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzIoTDeviceProvisioningServiceEnrollment
更新设备注册记录。
语法
Set-AzIoTDeviceProvisioningServiceEnrollment
[-ResourceGroupName] <String>
[-DpsName] <String>
-RegistrationId <String>
[-DeviceId <String>]
[-ReprovisionPolicy <PSReprovisionType>]
[-EdgeEnabled <Boolean>]
[-Tag <Hashtable>]
[-Desired <Hashtable>]
[-AllocationPolicy <PSAllocationPolicy>]
[-ProvisioningStatus <PSProvisioningStatus>]
[-IotHubHostName <String>]
[-IotHub <String[]>]
[-WebhookUrl <String>]
[-ApiVersion <String>]
[-EndorsementKey <String>]
[-StorageRootKey <String>]
[-PrimaryKey <String>]
[-SecondaryKey <String>]
[-PrimaryCertificate <String>]
[-SecondaryCertificate <String>]
[-RootCertificate]
[-PrimaryCAName <String>]
[-SecondaryCAName <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzIoTDeviceProvisioningServiceEnrollment
[-DpsObject] <PSProvisioningServiceDescription>
-RegistrationId <String>
[-DeviceId <String>]
[-ReprovisionPolicy <PSReprovisionType>]
[-EdgeEnabled <Boolean>]
[-Tag <Hashtable>]
[-Desired <Hashtable>]
[-AllocationPolicy <PSAllocationPolicy>]
[-ProvisioningStatus <PSProvisioningStatus>]
[-IotHubHostName <String>]
[-IotHub <String[]>]
[-WebhookUrl <String>]
[-ApiVersion <String>]
[-EndorsementKey <String>]
[-StorageRootKey <String>]
[-PrimaryKey <String>]
[-SecondaryKey <String>]
[-PrimaryCertificate <String>]
[-SecondaryCertificate <String>]
[-RootCertificate]
[-PrimaryCAName <String>]
[-SecondaryCAName <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-AzIoTDeviceProvisioningServiceEnrollment
[-ResourceId] <String>
-RegistrationId <String>
[-DeviceId <String>]
[-ReprovisionPolicy <PSReprovisionType>]
[-EdgeEnabled <Boolean>]
[-Tag <Hashtable>]
[-Desired <Hashtable>]
[-AllocationPolicy <PSAllocationPolicy>]
[-ProvisioningStatus <PSProvisioningStatus>]
[-IotHubHostName <String>]
[-IotHub <String[]>]
[-WebhookUrl <String>]
[-ApiVersion <String>]
[-EndorsementKey <String>]
[-StorageRootKey <String>]
[-PrimaryKey <String>]
[-SecondaryKey <String>]
[-PrimaryCertificate <String>]
[-SecondaryCertificate <String>]
[-RootCertificate]
[-PrimaryCAName <String>]
[-SecondaryCAName <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
更新 Azure IoT 中心设备预配服务中的设备注册。
示例
示例 1
Set-AzIoTDeviceProvisioningServiceEnrollment -ResourceGroupName "myresourcegroup" -DpsName "mydps" -RegistrationId "enroll1" -AllocationPolicy Hashed -IotHub "hub1","hub2"更新注册记录的分配策略和中心。
示例 2
$tag = @{}
$tag.Add("environment","updatedenv")
$desired = @{}
$desired.add("version_dps", "updateddps")
Set-AzIoTDeviceProvisioningServiceEnrollment -ResourceGroupName "myresourcegroup" -DpsName "mydps" -RegistrationId "enroll1" -tag $tag -Desired $desired更新注册的初始孪生状态。
示例 3
Set-AzIoTDeviceProvisioningServiceEnrollment -ResourceGroupName "myresourcegroup" -DpsName "mydps" -RegistrationId "enroll1" -PrimaryCertificate ".\primaryCertificate.cer" -SecondaryCertificate ".\secondaryCertificate.cer"更新对称密钥注册的主证书和辅助证书
参数
-AllocationPolicy
分配给中心的设备的分配类型。
| 类型: | PSAllocationPolicy |
| 接受的值: | Hashed, GeoLatency, Static, Custom |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ApiVersion
自定义分配请求中预配服务的 API 版本。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
| 类型: | IAzureContextContainer |
| 别名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Desired
初始孪生所需属性。
| 类型: | Hashtable |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeviceId
IoT 中心设备 ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DpsName
IoT 设备预配服务的名称
| 类型: | String |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-DpsObject
IoT 设备预配服务对象
| 类型: | PSProvisioningServiceDescription |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-EdgeEnabled
指示边缘启用的标志。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EndorsementKey
TPM 设备的 TPM 认可密钥。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-IotHub
目标 IoT 中心的主机名。 对多个 IoT 中心使用空格分隔的列表。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-IotHubHostName
目标 IoT 中心的主机名。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PrimaryCAName
主根 CA 证书的名称。 如果需要使用根 CA 证书进行证明，则必须提供根 CA 名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PrimaryCertificate
包含主证书的文件的路径。 X509 证书.cer文件或 .pem 文件路径的 Base-64 表示形式。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PrimaryKey
以 base64 格式存储的主对称共享访问密钥。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ProvisioningStatus
启用或禁用注册条目。
| 类型: | PSProvisioningStatus |
| 接受的值: | Enabled, Disabled |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RegistrationId
单个注册注册 ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ReprovisionPolicy
在重新预配到不同的 IoT 中心时要处理的设备数据。
| 类型: | PSReprovisionType |
| 接受的值: | reprovisionandmigratedata, reprovisionandresetdata, never |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ResourceGroupName
资源组的名称
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ResourceId
IoT 设备预配服务资源 ID
| 类型: | String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-RootCertificate
切换到使用根证书更新 X509attestation。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SecondaryCAName
辅助根 CA 证书的名称。 如果需要使用根 CA 证书进行证明，则必须提供根 CA 名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SecondaryCertificate
包含辅助证书的文件的路径。 X509 证书.cer文件或 .pem 文件路径的 Base-64 表示形式。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SecondaryKey
以 base64 格式存储的辅助对称共享访问密钥。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-StorageRootKey
TPM 设备的 TPM 存储根密钥。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Tag
初始孪生标记。
| 类型: | Hashtable |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WebhookUrl
用于自定义分配请求的 Webhook URL。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
PSProvisioningServiceDescription
