Compartilhar via

az iot hub state

  • Habilitação
  • Referência

Observação

Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.46.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az iot hub state . Saiba mais sobre extensões.

Este grupo de comando é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerenciar o estado de um Hub IoT.

Para obter mais informações, consulte aka.ms/aziotcli-iot-hub-state.

Comandos

Nome Description Tipo Status
az iot hub state export

Exporte o estado de um Hub IoT para um arquivo.

 Extensão Habilitação
az iot hub state import

Importe um estado de Hub de um arquivo para um Hub IoT.

 Extensão Habilitação
az iot hub state migrate

Migre o estado de um hub para outro hub sem salvar em um arquivo.

 Extensão Habilitação

az iot hub state export

Habilitação

O grupo de comando 'iot hub state' é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Exporte o estado de um Hub IoT para um arquivo.

Por padrão, o estado exportado incluirá: modelo de braço para hub, configurações de hub (incluindo configurações de ADM e implantações de borda), informações de dispositivo (incluindo identificações de dispositivo, gêmeos de dispositivo, identidades de módulo e gêmeos de módulo).

Para obter mais informações, consulte aka.ms/aziotcli-iot-hub-state.

az iot hub state export --state-file
                        [--aspects {arm, configurations, devices}]
                        [--auth-type {key, login}]
                        [--hub-name]
                        [--login]
                        [--replace]
                        [--resource-group]

Exemplos

Exporte o estado com suporte do hub especificado para o arquivo especificado.

az iot hub state export -n {iothub_name} -f {state_filename}

Exporte o estado suportado do hub especificado para o arquivo especificado, substituindo o conteúdo do arquivo.

az iot hub state export -n {iothub_name} -f {state_filename} -r

Exporte somente os dispositivos e as configurações do hub especificado para o arquivo especificado.

az iot hub state export -n {iothub_name} -f {state_filename} --aspects devices configurations

Parâmetros Exigidos

--state-file -f

O caminho para o arquivo onde as informações de estado serão armazenadas.

Parâmetros Opcionais

--aspects

Aspectos de Hub (separados por espaço).

Valores aceitos: arm, configurations, devices
--auth-type

Indica se a operação deve derivar automaticamente uma chave de política ou usar a sessão atual do Azure AD. Se o tipo de autenticação for login e o nome do host do recurso for fornecido, a pesquisa de recursos será ignorada, a menos que necessário. Você pode configurar o padrão usando az configure --defaults iothub-data-auth-type=<auth-type-value>o .

Valores aceitos: key, login
Valor padrão: key
--hub-name -n

Nome do Hub IoT ou nome do host. Obrigatório se --login não for fornecido.

--login -l

Esse comando oferece suporte a uma cadeia de conexão de entidade com direitos para executar ações. Use para evitar o login da sessão via "az login". Se uma cadeia de conexão de entidade e um nome forem fornecidos, a cadeia de conexão terá prioridade. Obrigatório se --hub-name não for fornecido.

--replace -r

Se esse sinalizador estiver definido, o comando substituirá o conteúdo do arquivo de saída.

Valor padrão: False
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot hub state import

Habilitação

O grupo de comando 'iot hub state' é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Importe um estado de Hub de um arquivo para um Hub IoT.

Se o aspecto arm for especificado, o hub será criado se ele não existir.

Por padrão, o estado importado incluirá: modelo de braço para hub, configurações de hub (incluindo configurações de ADM e implantações de borda), informações de dispositivo (incluindo identificações de dispositivo, gêmeos de dispositivo, identidades de módulo e gêmeos de módulo).

Para pontos de extremidade importados com autenticação de identidade atribuída ao sistema, o hub especificado deve ter as permissões corretas. Caso contrário, o comando falhará.

Os pontos de extremidade privados serão ignorados no processo de importação.

Para obter mais informações, consulte aka.ms/aziotcli-iot-hub-state.

az iot hub state import --state-file
                        [--aspects {arm, configurations, devices}]
                        [--auth-type {key, login}]
                        [--hub-name]
                        [--login]
                        [--replace]
                        [--resource-group]

Exemplos

Importe o estado com suporte do arquivo especificado para o hub especificado.

az iot hub state import -n {iothub_name} -f {state_filename}

Importe o estado com suporte do arquivo especificado para o hub especificado, substituindo o estado anterior do hub. Todos os certificados, configurações e dispositivos serão excluídos antes que o novo estado seja carregado.

az iot hub state import -n {iothub_name} -f {state_filename} -r

Importe apenas o modelo arm do arquivo especificado para o hub especificado. Observe que isso criará um novo hub se ele não existir. O arquivo pode conter os dispositivos e configurações, mas eles serão ignorados.

az iot hub state import -n {iothub_name} -g {resource_group} -f {state_filename} --aspects arm

Importe apenas os dispositivos e as configurações do arquivo especificado para o hub especificado. Observe que isso NÃO criará um novo hub se ele não existir e o comando falhará. O arquivo pode conter o modelo arm, mas isso será ignorado.

az iot hub state import -n {iothub_name} -f {state_filename} --aspects devices configurations

Parâmetros Exigidos

--state-file -f

O caminho para o arquivo onde as informações de estado serão armazenadas.

Parâmetros Opcionais

--aspects

Aspectos de Hub (separados por espaço).

Valores aceitos: arm, configurations, devices
--auth-type

Indica se a operação deve derivar automaticamente uma chave de política ou usar a sessão atual do Azure AD. Se o tipo de autenticação for login e o nome do host do recurso for fornecido, a pesquisa de recursos será ignorada, a menos que necessário. Você pode configurar o padrão usando az configure --defaults iothub-data-auth-type=<auth-type-value>o .

Valores aceitos: key, login
Valor padrão: key
--hub-name -n

Nome do Hub IoT ou nome do host. Obrigatório se --login não for fornecido.

--login -l

Esse comando oferece suporte a uma cadeia de conexão de entidade com direitos para executar ações. Use para evitar o login da sessão via "az login". Se uma cadeia de conexão de entidade e um nome forem fornecidos, a cadeia de conexão terá prioridade. Obrigatório se --hub-name não for fornecido.

--replace -r

Se esse sinalizador estiver definido, o comando excluirá os dispositivos, as configurações e os certificados atuais do hub de destino.

Valor padrão: False
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot hub state migrate

Habilitação

O grupo de comando 'iot hub state' é experimental e está em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Migre o estado de um hub para outro hub sem salvar em um arquivo.

Se o aspecto arm for especificado, o hub será criado se ele não existir.

Por padrão, o estado migrado incluirá: modelo de braço para hub, configurações de hub (incluindo configurações de ADM e implantações de borda), informações de dispositivo (incluindo identificações de dispositivo, gêmeos de dispositivo, identidades de módulo e gêmeos de módulo).

Para pontos de extremidade migrados com autenticação de identidade atribuída ao sistema, o hub especificado deve ter as permissões corretas. Caso contrário, o comando falhará.

Os pontos de extremidade privados serão ignorados no processo de migração.

Se você tiver problemas para migrar, use os comandos de exportação e importação para ter um arquivo como backup.

Para obter mais informações, consulte aka.ms/aziotcli-iot-hub-state.

az iot hub state migrate [--aspects {arm, configurations, devices}]
                         [--auth-type {key, login}]
                         [--destination-hub]
                         [--destination-hub-login]
                         [--destination-resource-group]
                         [--og]
                         [--oh]
                         [--ol]
                         [--replace]

Exemplos

Migre o estado com suporte do hub de origem para o hub de destino.

az iot hub state migrate --destination-hub {dest_hub_name} --origin-hub {orig_hub_name}

Migre o estado com suporte do hub de origem para o hub de destino, substituindo o estado anterior do hub. Todos os certificados, configurações e dispositivos no hub de destino serão excluídos antes que o novo estado seja carregado.

az iot hub state migrate --destination-hub {dest_hub_name} --origin-hub {orig_hub_name} -r

Migre apenas o modelo arm do hub de origem para o hub de destino. Observe que isso criará um novo hub se o hub de destino não existir. O hub de origem pode conter os dispositivos e configurações, mas eles serão ignorados.

az iot hub state migrate --destination-hub {dest_hub_name} --destination-resource-group {dest_hub_resource_group} --origin-hub {orig_hub_name} --aspects arm

Migre apenas os dispositivos e as configurações do hub de origem para o hub de destino. Observe que isso NÃO criará um novo hub se o hub de destino não existir e o comando falhar. O modelo de braço para o hub de origem será ignorado.

az iot hub state migrate --destination-hub {dest_hub_name} --origin-hub {orig_hub_name} --aspects devices configurations

Parâmetros Opcionais

--aspects

Aspectos de Hub (separados por espaço).

Valores aceitos: arm, configurations, devices
--auth-type

Indica se a operação deve derivar automaticamente uma chave de política ou usar a sessão atual do Azure AD. Se o tipo de autenticação for login e o nome do host do recurso for fornecido, a pesquisa de recursos será ignorada, a menos que necessário. Você pode configurar o padrão usando az configure --defaults iothub-data-auth-type=<auth-type-value>o .

Valores aceitos: key, login
Valor padrão: key
--destination-hub --dh

Nome do Hub IoT para o qual o estado do hub de origem será copiado.

--destination-hub-login --dl

Esse comando oferece suporte a uma cadeia de conexão de entidade com direitos para executar ações no hub de destino. Use para evitar o logon de sessão via az login para esta instância do Hub IoT. Se uma cadeia de conexão de entidade e um nome forem fornecidos, a cadeia de conexão terá prioridade. Obrigatório se --destination-hub não for fornecido.

--destination-resource-group --dg

Nome do grupo de recursos do Hub IoT para o qual o estado do hub de origem será copiado. Se não for fornecido, usará o grupo de recursos do Hub IoT de origem.

--og --origin-resource-group

Nome do grupo de recursos do Hub IoT que será copiado.

--oh --origin-hub

Nome do Hub IoT que será copiado.

--ol --origin-hub-login

Esse comando oferece suporte a uma cadeia de conexão de entidade com direitos para executar ações no hub de origem. Use para evitar o logon de sessão via az login para esta instância do Hub IoT. Se uma cadeia de conexão de entidade e um nome forem fornecidos, a cadeia de conexão terá prioridade. Obrigatório se --origin-hub não for fornecido.

--replace -r

Se esse sinalizador estiver definido, o comando excluirá os dispositivos, as configurações e os certificados atuais do hub de destino.

Valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.