Compartilhar via

az sig share

  • Referência

Observação

Esse grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Gerenciar perfil de compartilhamento de galeria.

Comandos

Nome Description Tipo Status
az sig share add

Compartilhar galeria com assinaturas e locatários.

 Núcleo GA
az sig share enable-community

Permitir compartilhar galeria com a comunidade.

 Núcleo GA
az sig share enable-community (image-gallery extensão)

Permitir compartilhar galeria com a comunidade.

 Extensão GA
az sig share remove

Pare de compartilhar a galeria com uma assinatura ou locatário.

 Núcleo GA
az sig share reset

Desabilite o compartilhamento da galeria com assinatura ou locatário.

 Núcleo GA
az sig share wait

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

 Núcleo GA

az sig share add

Compartilhar galeria com assinaturas e locatários.

az sig share add [--gallery-name]
                 [--ids]
                 [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                 [--resource-group]
                 [--subscription]
                 [--subscription-ids]
                 [--tenant-ids]

Exemplos

Compartilhe a galeria inteira com todos os membros de uma assinatura e/ou locatário.

az sig share add --resource-group MyResourceGroup --gallery-name MyGallery \
--subscription-ids subId1 subId2 --tenant-ids tenantId1 tenantId2

Parâmetros Opcionais

--gallery-name -r

O nome da Galeria de Imagens Compartilhadas.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--no-wait

Não aguarde a conclusão da operação de execução longa.

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

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

--subscription

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

--subscription-ids

Uma lista de IDs de assinatura para compartilhar a galeria. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--tenant-ids

Uma lista de IDs de locatário para compartilhar a galeria. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

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 sig share enable-community

Permitir compartilhar galeria com a comunidade.

az sig share enable-community [--gallery-name]
                              [--ids]
                              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                              [--resource-group]
                              [--subscription]
                              [--subscription-ids]
                              [--tenant-ids]

Exemplos

Permitir compartilhar galeria com a comunidade

az sig share enable-community --resource-group MyResourceGroup --gallery-name MyGallery

Parâmetros Opcionais

--gallery-name -r

O nome da Galeria de Imagens Compartilhadas.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--no-wait

Não aguarde a conclusão da operação de execução longa.

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

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

--subscription

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

--subscription-ids

Uma lista de IDs de assinatura para compartilhar a galeria. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--tenant-ids

Uma lista de IDs de locatário para compartilhar a galeria. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

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 sig share enable-community (image-gallery extensão)

Permitir compartilhar galeria com a comunidade.

az sig share enable-community [--gallery-name]
                              [--ids]
                              [--no-wait]
                              [--op-type]
                              [--resource-group]
                              [--subscription]
                              [--subscription-ids]
                              [--tenant-ids]

Exemplos

Permitir compartilhar galeria com a comunidade

az sig share enable-community --resource-group MyResourceGroup --gallery-name MyGallery

Parâmetros Opcionais

--gallery-name -r

O nome da Galeria de Imagens Compartilhadas.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
--op-type
Preterido

O argumento 'op_type' foi descontinuado e será removido em uma versão futura.

Distinguir adicionar operação e remover operação.

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

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

--subscription

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

--subscription-ids

Uma lista de IDs de assinatura para compartilhar a galeria.

--tenant-ids

Uma lista de IDs de locatário para compartilhar a galeria.

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 sig share remove

Pare de compartilhar a galeria com uma assinatura ou locatário.

az sig share remove [--gallery-name]
                    [--ids]
                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                    [--resource-group]
                    [--subscription]
                    [--subscription-ids]
                    [--tenant-ids]

Exemplos

Parar de compartilhar com uma assinatura ou ID de locatário

az sig share remove --resource-group MyResourceGroup --gallery-name MyGallery \
--subscription-ids subId1 subId2 --tenant-ids tenantId1 tenantId2

Parâmetros Opcionais

--gallery-name -r

O nome da Galeria de Imagens Compartilhadas.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--no-wait

Não aguarde a conclusão da operação de execução longa.

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

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

--subscription

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

--subscription-ids

Uma lista de IDs de assinatura para compartilhar a galeria. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

--tenant-ids

Uma lista de IDs de locatário para compartilhar a galeria. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

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 sig share reset

Desabilite o compartilhamento da galeria com assinatura ou locatário.

az sig share reset [--gallery-name]
                   [--ids]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--resource-group]
                   [--subscription]

Exemplos

Redefina o perfil de compartilhamento de uma galeria.

az sig share reset --resource-group MyResourceGroup --gallery-name MyGallery

Parâmetros Opcionais

--gallery-name -r

O nome da Galeria de Imagens Compartilhadas.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--no-wait

Não aguarde a conclusão da operação de execução longa.

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

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

--subscription

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

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 sig share wait

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

az sig share wait [--created]
                  [--custom]
                  [--deleted]
                  [--exists]
                  [--expand {SharingProfile/Groups}]
                  [--gallery-name]
                  [--ids]
                  [--interval]
                  [--resource-group]
                  [--select {Permissions}]
                  [--subscription]
                  [--timeout]
                  [--updated]

Exemplos

Coloque a CLI em um estado de espera até que o objeto de compartilhamento da galeria seja atualizado.

az sig share wait --updated --resource-group MyResourceGroup --gallery-name Gallery

Parâmetros Opcionais

--created

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

Valor padrão: 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 padrão: False
--exists

Aguarde até que o recurso exista.

Valor padrão: False
--expand

A opção expandir consulta a ser aplicada na operação.

Valores aceitos: SharingProfile/Groups
--gallery-name -r

O nome da Galeria de Imagens Compartilhadas a ser excluída.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--interval

Intervalo de sondagem em segundos.

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

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

--select

A expressão select a ser aplicada na operação.

Valores aceitos: Permissions
--subscription

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

--timeout

Espera máxima em segundos.

Valor padrão: 3600
--updated

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

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.