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

New-AzIotHubSasToken

参考

模块:: Az.IotHub

为目标IoT 中心、设备或模块生成 SAS 令牌。

语法

New-AzIotHubSasToken
   [-ResourceGroupName] <String>
   [-IotHubName] <String>
   [-DeviceId <String>]
   [-ModuleId <String>]
   [-KeyName <String>]
   [-KeyType <PSKeyType>]
   [-Duration <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzIotHubSasToken
   [-InputObject] <PSIotHub>
   [-DeviceId <String>]
   [-ModuleId <String>]
   [-KeyName <String>]
   [-KeyType <PSKeyType>]
   [-Duration <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzIotHubSasToken
   [-ResourceId] <String>
   [-DeviceId <String>]
   [-ModuleId <String>]
   [-KeyName <String>]
   [-KeyType <PSKeyType>]
   [-Duration <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

对于设备 SAS 令牌，策略参数仅用于访问设备注册表。因此，策略应具有注册表的读取访问权限。对于IoT 中心令牌，策略是 SAS 的一部分。

示例

示例 1

New-AzIotHubSasToken -ResourceGroupName "myresourcegroup" -IotHubName "myiothub"

使用 iothubowner 策略和主密钥生成IoT 中心 SAS 令牌。

示例 2

New-AzIotHubSasToken -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -KeyName "registryRead" -KeyType "secondary"

使用 registryRead 策略和辅助密钥生成IoT 中心 SAS 令牌。

示例 3

New-AzIotHubSasToken -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1"

使用 iothubowner 策略生成设备 SAS 令牌，以访问 {iothub_name} 设备注册表。

示例 4

New-AzIotHubSasToken -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -ModuleId "myModule1"

使用 iothubowner 策略生成模块 SAS 令牌，以访问 {iothub_name} 设备注册表。

参数

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeviceId

目标设备 ID。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Duration

要生成的令牌的未来到期时间（以秒为单位）。默认值为 3600。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

IotHub 对象

Type:	PSIotHub
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IotHubName

IoT 中心的名称

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyName

访问密钥名称。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyType

访问密钥类型。

Type:	PSKeyType
Accepted values:	primary, secondary
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ModuleId

目标模块 ID。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

资源组的名称

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

IotHub 资源 ID

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

PSIotHub

String

输出