Compartilhar via


Set-AzIotHubConfiguration

Atualize os campos mutáveis do registro de configuração.

Syntax

Set-AzIotHubConfiguration
   [-ResourceGroupName] <String>
   [-IotHubName] <String>
   [-Name] <String>
   [-Priority <Int32>]
   [-TargetCondition <String>]
   [-Metric <Hashtable>]
   [-Label <Hashtable>]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzIotHubConfiguration
   [-InputObject] <PSIotHub>
   [-Name] <String>
   [-Priority <Int32>]
   [-TargetCondition <String>]
   [-Metric <Hashtable>]
   [-Label <Hashtable>]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzIotHubConfiguration
   [-ResourceId] <String>
   [-Name] <String>
   [-Priority <Int32>]
   [-TargetCondition <String>]
   [-Metric <Hashtable>]
   [-Label <Hashtable>]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Atualize as propriedades especificadas de uma configuração de gerenciamento automático de dispositivos IoT. Nota: O conteúdo de configuração é imutável. As propriedades de configuração que podem ser atualizadas são 'labels', 'metrics', 'priority' e 'targetCondition'. Consulte https://learn.microsoft.com/azure/iot-hub/iot-hub-automatic-device-management para obter mais informações.

Exemplos

Exemplo 1

Set-AzIotHubConfiguration -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -Name "config1" -Priority 7 -TargetCondition "tags.building=3 and tags.environment='dev'"

Alterar a prioridade de uma configuração de dispositivo e atualizar sua condição de destino

Exemplo 2

$labels = @{}
$labels.add("key0","value0")
$metrics = @{}
$metrics.add("query1", "select deviceId from devices where tags.location='US'")
Set-AzIotHubConfiguration -ResourceGroupName "myresourcegroup" -IotHubName "myiothub" -Name "config1" -Label $labels -Metric $metrics

Atualizar as métricas e rótulos de uma configuração de dispositivo

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

-Force

Permite que o objeto de configuração seja substituído mesmo que tenha sido atualizado desde que foi recuperado da última vez.

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

-Label

Mapa de rótulos a serem aplicados à configuração de destino.

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

-Metric

Coleta de consultas para definição de métricas de configuração.

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

-Name

Identificador da configuração.

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

-Priority

Peso da configuração do dispositivo em caso de regras concorrentes (maiores vitórias).

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

-TargetCondition

Condição de destino na qual uma configuração de dispositivo se aplica.

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

PSConfiguration