Compartilhar via


Update-AzIotHubModuleTwin

Atualiza as tags e as propriedades desejadas de um gêmeo do módulo de dispositivo IoT.

Syntax

Update-AzIotHubModuleTwin
      [-ResourceGroupName] <String>
      [-IotHubName] <String>
      [-DeviceId] <String>
      -ModuleId <String>
      [-Tag <Hashtable>]
      [-Desired <Hashtable>]
      [-Partial]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzIotHubModuleTwin
      [-InputObject] <PSIotHub>
      [-DeviceId] <String>
      -ModuleId <String>
      [-Tag <Hashtable>]
      [-Desired <Hashtable>]
      [-Partial]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzIotHubModuleTwin
      [-ResourceId] <String>
      [-DeviceId] <String>
      -ModuleId <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-module-twins para obter mais informações.

Exemplos

Exemplo 1

Update-AzIotHubModuleTwin -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -ModuleId "myModule1" -Tag $updatedTag -Desired $updatedDesired -Partial

Retorna o objeto gêmeo do módulo de dispositivo atualizado.

Exemplo 2

Update-AzIotHubModuleTwin -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -ModuleId "myModule1" -Desired $updatedDesired -Partial

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

Exemplo 3

Update-AzIotHubModuleTwin -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -ModuleId "myModule1" -Tag $updatedTag -Partial

Retorna o objeto gêmeo do módulo de dispositivo com a propriedade de marcas atualizada.

Exemplo 4

Update-AzIotHubModuleTwin -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -DeviceId "myDevice1" -ModuleId "myModule1" -Tag $updatedTag -Desired $updatedDesired

Retorna o objeto gêmeo do módulo 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 módulo gêmeo.

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

-ModuleId

ID do módulo de destino.

Tipo:String
Position:Named
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 módulo 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 módulo gêmeo.

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

PSModuleTwin