Partilhar via


az orbital spacecraft

Nota

Essa referência faz parte da extensão orbital da CLI do Azure (versão 2.39.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando de espaçonave orbital az. Saiba mais sobre extensões.

Os satélites devem ser registrados como uma espaçonave no Azure Orbital para estabelecer contatos com o satélite.

Comandos

Name Description Tipo Estado
az orbital spacecraft contact

No horário agendado, a estação terrestre selecionada entrará em contato com a espaçonave e iniciará a recuperação/entrega de dados usando o perfil de contato.

Extensão GA
az orbital spacecraft contact create

Crie um contato.

Extensão GA
az orbital spacecraft contact delete

Exclua um contato especificado.

Extensão GA
az orbital spacecraft contact list

Listar contatos por espaçonave.

Extensão GA
az orbital spacecraft contact show

Obtenha o contato especificado em um grupo de recursos especificado.

Extensão GA
az orbital spacecraft contact wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

Extensão GA
az orbital spacecraft create

Crie um recurso de espaçonave.

Extensão GA
az orbital spacecraft delete

Exclua um recurso de espaçonave especificado.

Extensão GA
az orbital spacecraft list

Listar espaçonaves.

Extensão GA
az orbital spacecraft list-available-contact

Listar contatos disponíveis. Um contato está disponível se a espaçonave estiver visível da estação terrestre por mais do que a duração mínima viável de contato fornecida no perfil de contato.

Extensão GA
az orbital spacecraft show

Obtenha a espaçonave especificada em um grupo de recursos especificado.

Extensão GA
az orbital spacecraft update

Atualize a espaçonave.

Extensão GA
az orbital spacecraft wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

Extensão GA

az orbital spacecraft create

Crie um recurso de espaçonave.

az orbital spacecraft create --name
                             --resource-group
                             [--links]
                             [--location]
                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                             [--norad-id]
                             [--tags]
                             [--title-line]
                             [--tle-line1]
                             [--tle-line2]

Exemplos

Criar uma nave espacial

az orbital spacecraft create --name <spacecraft-name> --resource-group <resource-group> -l eastus --norad-id 27424 --title-line "AQUA" --tle-line1 "1 27424U 02022A   22192.74014189  .00000435  00000+0  10624-3 0  9992" --tle-line2 "2 27424  98.2482 134.4016 0001650 100.5984  12.3416 14.57323336 73769" --links "[{name:downlink,bandwidth-m-hz:15,center-frequency-m-hz:8160,polarization:RHCP,direction:Downlink}]"

Parâmetros Obrigatórios

--name --spacecraft-name -n

ID da nave espacial.

--resource-group -g

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

Parâmetros Opcionais

--links

Lista imutável de links de espaçonaves. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--location -l

A localização geográfica onde o recurso reside Quando não especificada, a localização do grupo de recursos será usada.

--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--norad-id

NORAD ID da nave espacial.

--tags

Tags de recursos. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--title-line

Linha de título do conjunto de elementos de duas linhas (TLE).

--tle-line1

Linha 1 do conjunto de elementos de duas linhas (TLE).

--tle-line2

Linha 2 do conjunto de elementos de duas linhas (TLE).

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az orbital spacecraft delete

Exclua um recurso de espaçonave especificado.

az orbital spacecraft delete [--ids]
                             [--name]
                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                             [--resource-group]
                             [--subscription]
                             [--yes]

Exemplos

Excluir espaçonave

az orbital spacecraft delete --name <spacecraft-name> --resource-group <resource-group>

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name --spacecraft-name -n

ID da nave espacial.

--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az orbital spacecraft list

Listar espaçonaves.

az orbital spacecraft list [--resource-group]
                           [--skiptoken]

Exemplos

Listar espaçonaves por assinatura

az orbital spacecraft list

Listar espaçonaves por grupo de recursos

az orbital spacecraft list -g <resource-group>

Parâmetros Opcionais

--resource-group -g

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

--skiptoken

Uma cadeia de caracteres opaca que o provedor de recursos usa para ignorar resultados retornados anteriormente. Isso é usado quando uma chamada de operação de lista anterior retornou um resultado parcial. Se uma resposta anterior contiver um elemento nextLink, o valor do elemento nextLink incluirá um parâmetro skiptoken que especifica um ponto de partida a ser usado para chamadas subsequentes.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az orbital spacecraft list-available-contact

Listar contatos disponíveis. Um contato está disponível se a espaçonave estiver visível da estação terrestre por mais do que a duração mínima viável de contato fornecida no perfil de contato.

az orbital spacecraft list-available-contact --contact-profile
                                             --end-time
                                             --ground-station-name
                                             --resource-group
                                             --spacecraft-name
                                             --start-time
                                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Exemplos

Listar contatos disponíveis

az orbital spacecraft list-available-contact -g <resource-group> --spacecraft-name <spacecraft-name> --contact-profile "{id:<contact-profile-id>}" --ground-station-name <ground-station-name> --start-time "2022-11-14T00:55:31.820Z" --end-time "2022-11-15T00:55:31.820Z"

Parâmetros Obrigatórios

--contact-profile

A referência ao recurso de perfil de contato. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--end-time

Hora de fim de um contacto (norma ISO 8601 UTC).

--ground-station-name

Nome da Estação Terrestre do Azure.

--resource-group -g

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

--spacecraft-name

ID da nave espacial.

--start-time

Hora de início de um contacto (norma ISO 8601 UTC).

Parâmetros Opcionais

--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az orbital spacecraft show

Obtenha a espaçonave especificada em um grupo de recursos especificado.

az orbital spacecraft show [--ids]
                           [--name]
                           [--resource-group]
                           [--subscription]

Exemplos

Obter naves espaciais

az orbital spacecraft show --name <spacecraft-name> --resource-group <resource-group>

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name --spacecraft-name -n

ID da nave espacial.

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az orbital spacecraft update

Atualize a espaçonave.

az orbital spacecraft update [--add]
                             [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                             [--ids]
                             [--location]
                             [--name]
                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                             [--norad-id]
                             [--remove]
                             [--resource-group]
                             [--set]
                             [--subscription]
                             [--tags]
                             [--title-line]
                             [--tle-line1]
                             [--tle-line2]

Exemplos

Atualizar tags de espaçonaves

az orbital spacecraft update --name <spacecraft-name> --resource-group <resource-group> --tags "{tag1:value1,tag2:value2}"

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string ou JSON string>.

--force-string

Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--location -l

A geolocalização onde o recurso vive.

--name --spacecraft-name -n

ID da nave espacial.

--no-wait

Não espere que a operação de longa duração termine.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--norad-id

NORAD ID da nave espacial.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list OR --remove propertyToRemove.

--resource-group -g

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

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--tags

Tags de recursos. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--title-line

Linha de título do conjunto de elementos de duas linhas (TLE).

--tle-line1

Linha 1 do conjunto de elementos de duas linhas (TLE).

--tle-line2

Linha 2 do conjunto de elementos de duas linhas (TLE).

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az orbital spacecraft wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

az orbital spacecraft wait [--created]
                           [--custom]
                           [--deleted]
                           [--exists]
                           [--ids]
                           [--interval]
                           [--name]
                           [--resource-group]
                           [--subscription]
                           [--timeout]
                           [--updated]

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

valor predefinido: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

valor predefinido: False
--exists

Aguarde até que o recurso exista.

valor predefinido: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

valor predefinido: 30
--name --spacecraft-name -n

ID da nave espacial.

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--timeout

Espera máxima em segundos.

valor predefinido: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.