Partilhar via

az sig share

  • Referência

Observação

Este 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

Name Description Tipo Status
az sig share add

Partilhe a galeria com subscrições e inquilinos.

 Núcleo GA
az sig share enable-community

Permitir compartilhar galeria para a comunidade.

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

Permitir compartilhar galeria para a comunidade.

 Extensão GA
az sig share remove

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

 Núcleo GA
az sig share reset

Desative a galeria de ser compartilhada com a assinatura ou o 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

Partilhe a galeria com subscrições e inquilinos.

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

Partilhe toda a galeria com todos os membros de uma subscrição e/ou inquilino.

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

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'.

--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

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

--subscription

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

--subscription-ids

Uma lista de IDs de assinatura com as quais compartilhar a galeria. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--tenant-ids

Uma lista de ids de locatário com as quais compartilhar a galeria. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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
Default value: json
--query

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

--subscription

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

--verbose

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

az sig share enable-community

Permitir compartilhar galeria para 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 para 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

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'.

--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

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

--subscription

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

--subscription-ids

Uma lista de IDs de assinatura com as quais compartilhar a galeria. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--tenant-ids

Uma lista de ids de locatário com as quais compartilhar a galeria. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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
Default value: json
--query

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

--subscription

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

--verbose

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

az sig share enable-community (image-gallery extensão)

Permitir compartilhar galeria para 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 para 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

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'.

--no-wait

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

Default value: False
--op-type
Preterido

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

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

Default value: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--subscription-ids

Uma lista de IDs de subscrição para partilhar a galeria.

--tenant-ids

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

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
Default value: json
--query

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

--subscription

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

--verbose

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

az sig share remove

Pare de compartilhar 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 partilhar com uma subscrição ou ID de inquilino

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

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'.

--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

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

--subscription

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

--subscription-ids

Uma lista de IDs de assinatura com as quais compartilhar a galeria. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--tenant-ids

Uma lista de ids de locatário com as quais compartilhar a galeria. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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
Default value: json
--query

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

--subscription

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

--verbose

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

az sig share reset

Desative a galeria de ser compartilhada com a assinatura ou o 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

Redefinir 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

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'.

--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

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

--subscription

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

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
Default value: json
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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 de 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'.

Default value: 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.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--expand

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

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

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

--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.

Default value: 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 aceites: Permissions
--subscription

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

--timeout

Espera máxima em segundos.

Default value: 3600
--updated

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

Default value: 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
Default value: json
--query

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

--subscription

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

--verbose

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