Update-AzIotHubDeviceTwin

Referência

Módulo:: Az.IotHub

Atualiza as tags e as propriedades desejadas de um gêmeo de dispositivo.

Syntax

Update-AzIotHubDeviceTwin
      [-ResourceGroupName] <String>
      [-IotHubName] <String>
      [-DeviceId] <String>
      [-Tag <Hashtable>]
      [-Desired <Hashtable>]
      [-Partial]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzIotHubDeviceTwin
      [-InputObject] <PSIotHub>
      [-DeviceId] <String>
      [-Tag <Hashtable>]
      [-Desired <Hashtable>]
      [-Partial]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzIotHubDeviceTwin
      [-ResourceId] <String>
      [-DeviceId] <String>
      [-Tag <Hashtable>]
      [-Desired <Hashtable>]
      [-Partial]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Atualiza ou substitui um gêmeo de dispositivo. Consulte https://learn.microsoft.com/azure/iot-hub/iot-hub-devguide-device-twins para obter mais informações.

Exemplos

Exemplo 1

Update-AzIotHubDeviceTwin -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -Tag $updatedTag -Desired $updatedDesired -Partial

Retorna o objeto gêmeo de dispositivo atualizado.

Exemplo 2

Update-AzIotHubDeviceTwin -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -Desired $updatedDesired -Partial

Retorna o objeto gêmeo do dispositivo com as propriedades desejadas atualizadas.

Exemplo 3

Update-AzIotHubDeviceTwin -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -Tag $updatedTag -Partial

Retorna a propriedade device twin object with updated tags.

Exemplo 4

$updatedTag = @{}
$updatedTag.add("key0","value0")
$updatedDesired =@{}
$updatedDesired.add("desiredkey","desiredvalue")
Update-AzIotHubDeviceTwin -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -Tag $updatedTag -Desired $updatedDesired

Retorna o objeto gêmeo de dispositivo substituído.

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

-Desired

Adicione ou atualize a propriedade desejada em um gêmeo de dispositivo.

Tipo:	Hashtable
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:	1
valor padrão:	None
Obrigatório:	True
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

-Partial

Permite atualizar apenas parcialmente as tags e propriedades desejadas de um dispositivo gêmeo.

Tipo:	SwitchParameter
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

-Tag

Adicione ou atualize a propriedade tags em um gêmeo de dispositivo.

Tipo:	Hashtable
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
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