Compartilhar via


New-AzIotHubSasToken

Gere um token SAS para um Hub, dispositivo ou módulo IoT de destino.

Syntax

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>]

Description

Para tokens SAS de dispositivo, o parâmetro de política é usado para acessar somente o registro do dispositivo. Portanto, a política deve ter acesso de leitura ao registro. Para tokens do Hub IoT, a política faz parte do SAS.

Exemplos

Exemplo 1

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

Gere um token SAS do Hub IoT usando a política iothubowner e a chave primária.

Exemplo 2

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

Gere um token SAS do Hub IoT usando a política registryRead e a chave secundária.

Exemplo 3

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

Gere um token SAS de dispositivo usando a política iothubowner para acessar o registro de dispositivo {iothub_name}.

Exemplo 4

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

Gere um token SAS de módulo usando a política iothubowner para acessar o registro de dispositivo {iothub_name}.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-DeviceId

ID do dispositivo de destino.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-Duration

Expiração futura (em segundos) do token a ser gerado. O padrão é 3600.

Tipo:Int32
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Objeto IotHub

Tipo:PSIotHub
Position:0
valor padrão:None
Obrigatório:True
Accept pipeline input:True
Accept wildcard characters:False

-IotHubName

Nome do Hub Iot

Tipo:String
Position:1
valor padrão:None
Obrigatório:True
Accept pipeline input:False
Accept wildcard characters:False

-KeyName

Nome da chave de acesso.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyType

Tipo de chave de acesso.

Tipo:PSKeyType
valores aceitos:primary, secondary
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-ModuleId

ID do módulo de destino.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Nome do grupo de recursos

Tipo:String
Position:0
valor padrão:None
Obrigatório:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceId

ID do recurso do IotHub

Tipo:String
Position:0
valor padrão:None
Obrigatório:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSIotHub

String

Saídas

String