Partilhar via


az sql mi

Gerencie instâncias gerenciadas SQL.

Comandos

Name Description Tipo Status
az sql mi ad-admin

Gerencie o administrador do Ative Directory de uma instância gerenciada.

Core disponibilidade geral
az sql mi ad-admin create

Cria uma nova instância gerenciada do administrador do Ative Directory.

Core disponibilidade geral
az sql mi ad-admin delete

Exclui uma instância gerenciada existente do Administrador do Ative Directory.

Core disponibilidade geral
az sql mi ad-admin list

Retorna uma lista de Administradores do Ative Directory de instância gerenciada.

Core disponibilidade geral
az sql mi ad-admin update

Atualiza um administrador do Ative Directory de instância gerenciada existente.

Core disponibilidade geral
az sql mi ad-only-auth

Gerencie as configurações somente do Azure Ative Directory de uma instância gerenciada.

Core disponibilidade geral
az sql mi ad-only-auth disable

Desative somente a Autenticação do Ative Directory do Azure para esta Instância Gerenciada.

Core disponibilidade geral
az sql mi ad-only-auth enable

Habilite a Autenticação somente do Ative Directory do Azure para esta Instância Gerenciada.

Core disponibilidade geral
az sql mi ad-only-auth get

Obtenha uma propriedade específica de Autenticação somente do Azure Ative Directory.

Core disponibilidade geral
az sql mi advanced-threat-protection-setting

Gerencie a configuração avançada de proteção contra ameaças de uma Instância Gerenciada SQL.

Core disponibilidade geral
az sql mi advanced-threat-protection-setting show

Obtém uma configuração avançada de proteção contra ameaças.

Core disponibilidade geral
az sql mi advanced-threat-protection-setting update

Atualize a configuração avançada de proteção contra ameaças de uma Instância Gerenciada SQL.

Core disponibilidade geral
az sql mi create

Crie uma instância gerenciada.

Core disponibilidade geral
az sql mi delete

Exclua uma instância gerenciada.

Core disponibilidade geral
az sql mi dtc

Comandos relacionados ao gerenciamento de DTC de instância gerenciada.

Core disponibilidade geral
az sql mi dtc show

Obtenha configurações de DTC de instância gerenciada.

Core disponibilidade geral
az sql mi dtc update

Atualize as configurações do DTC da instância gerenciada.

Core disponibilidade geral
az sql mi dtc wait

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

Core disponibilidade geral
az sql mi endpoint-cert

Comandos de gerenciamento de certificados de ponto final.

Core disponibilidade geral
az sql mi endpoint-cert list

Listar certificados usados em pontos de extremidade na instância de destino.

Core disponibilidade geral
az sql mi endpoint-cert show

Obtenha um certificado usado no ponto de extremidade com a ID fornecida.

Core disponibilidade geral
az sql mi failover

Failover de uma instância gerenciada.

Core disponibilidade geral
az sql mi key

Gerencie as chaves de uma instância SQL.

Core disponibilidade geral
az sql mi key create

Cria uma chave de instância SQL.

Core disponibilidade geral
az sql mi key delete

Exclui uma chave de instância SQL.

Core disponibilidade geral
az sql mi key list

Obtém uma lista de chaves de instância gerenciadas.

Core disponibilidade geral
az sql mi key show

Mostra uma chave de instância SQL.

Core disponibilidade geral
az sql mi link

Comandos de gerenciamento de link de instância.

Core disponibilidade geral
az sql mi link create

Crie um link de Instância Gerenciada entre Sql On-Prem e Instância Gerenciada Sql.

Core disponibilidade geral
az sql mi link delete

Solte um link de Instância Gerenciada entre Sql On-Prem e Instância Gerenciada Sql.

Core disponibilidade geral
az sql mi link failover

Executa o tipo de failover solicitado neste link de Instância Gerenciada.

Core disponibilidade geral
az sql mi link list

Obtenha uma lista de links de Instância Gerenciada na instância.

Core disponibilidade geral
az sql mi link show

Obtenha informações de link de uma instância gerenciada.

Core disponibilidade geral
az sql mi link update

Atualize um modo de replicação de link de Instância Gerenciada.

Core disponibilidade geral
az sql mi list

Listar instâncias gerenciadas disponíveis.

Core disponibilidade geral
az sql mi op

Gerencie operações em uma instância gerenciada.

Core disponibilidade geral
az sql mi op cancel

Cancela a operação assíncrona na instância gerenciada.

Core disponibilidade geral
az sql mi op list

Obtém uma lista de operações executadas na instância gerenciada.

Core disponibilidade geral
az sql mi op show

Obtém uma operação de gerenciamento em uma instância gerenciada.

Core disponibilidade geral
az sql mi partner-cert

Comandos de gerenciamento de certificados de confiança do servidor.

Core disponibilidade geral
az sql mi partner-cert create

Carregue um certificado de confiança do servidor da caixa para a Instância Gerenciada SQL.

Core disponibilidade geral
az sql mi partner-cert delete

Exclua um certificado de confiança do servidor que foi carregado da caixa para a Instância Gerenciada SQL.

Core disponibilidade geral
az sql mi partner-cert list

Obtenha uma lista de certificados de confiança do servidor que foram carregados da caixa para a Instância Gerenciada SQL fornecida.

Core disponibilidade geral
az sql mi partner-cert show

Obtenha um certificado de confiança do servidor que foi carregado da caixa para a Instância Gerenciada SQL.

Core disponibilidade geral
az sql mi refresh-external-governance-status

Atualize o status de habilitação de governança externa.

Core disponibilidade geral
az sql mi server-configuration-option

Comandos de gerenciamento de opções de configuração do servidor.

Core disponibilidade geral
az sql mi server-configuration-option list

Liste uma lista de opções de configuração do servidor de instância gerenciado.

Core disponibilidade geral
az sql mi server-configuration-option set

Defina a opção de configuração do servidor de instância gerenciada.

Core disponibilidade geral
az sql mi server-configuration-option show

Obtenha a opção de configuração do servidor de instância gerenciado.

Core disponibilidade geral
az sql mi server-configuration-option wait

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

Core disponibilidade geral
az sql mi show

Obtenha os detalhes de uma instância gerenciada.

Core disponibilidade geral
az sql mi start

Inicie a instância gerenciada.

Core disponibilidade geral
az sql mi start-stop-schedule

Gerencie o cronograma de parada de início da instância gerenciada.

Core disponibilidade geral
az sql mi start-stop-schedule create

Crie a agenda Start/Stop da instância gerenciada.

Core disponibilidade geral
az sql mi start-stop-schedule delete

Exclua a agenda Start/Stop da instância gerenciada.

Core disponibilidade geral
az sql mi start-stop-schedule list

Liste as agendas Start/Stop da instância gerenciada.

Core disponibilidade geral
az sql mi start-stop-schedule show

Obtenha o cronograma Start/Stop da instância gerenciada.

Core disponibilidade geral
az sql mi start-stop-schedule update

Atualize a agenda Start/Stop da instância gerenciada.

Core disponibilidade geral
az sql mi stop

Pare a instância gerenciada.

Core disponibilidade geral
az sql mi tde-key

Gerencie o protetor de criptografia de uma instância SQL.

Core disponibilidade geral
az sql mi tde-key set

Define o protetor de criptografia da Instância SQL.

Core disponibilidade geral
az sql mi tde-key show

Mostra um protetor de criptografia do servidor.

Core disponibilidade geral
az sql mi update

Atualize uma instância gerenciada.

Core disponibilidade geral

az sql mi create

Crie uma instância gerenciada.

az sql mi create --name
                 --resource-group
                 --subnet
                 [--admin-password]
                 [--admin-user]
                 [--am --authentication-metadata {AzureAD, Paired, Windows}]
                 [--assign-identity]
                 [--backup-storage-redundancy --bsr]
                 [--capacity]
                 [--collation]
                 [--database-format {AlwaysUpToDate, SQLServer2022}]
                 [--dns-zone-partner]
                 [--edition --tier]
                 [--enable-ad-only-auth]
                 [--external-admin-name]
                 [--external-admin-principal-type]
                 [--external-admin-sid]
                 [--family]
                 [--gpv2 {false, true}]
                 [--identity-type {None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned}]
                 [--instance-pool-name]
                 [--iops]
                 [--key-id]
                 [--license-type {BasePrice, LicenseIncluded}]
                 [--location]
                 [--maint-config-id]
                 [--minimal-tls-version {1.0, 1.1, 1.2, None}]
                 [--no-wait]
                 [--pid --primary-user-assigned-identity-id]
                 [--pricing-model {Freemium, Regular}]
                 [--proxy-override {Default, Proxy, Redirect}]
                 [--public-data-endpoint-enabled {false, true}]
                 [--service-principal-type {None, SystemAssigned}]
                 [--storage]
                 [--tags]
                 [--timezone-id]
                 [--user-assigned-identity-id]
                 [--vnet-name]
                 [--yes]
                 [--zone-redundant {false, true}]

Exemplos

Criar uma instância gerenciada com um conjunto mínimo de parâmetros

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName}

Criar uma instância gerenciada com parâmetros especificados e com identidade

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --license-type LicenseIncluded --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --capacity 8 --storage 32GB --edition GeneralPurpose --family Gen5

Criar instância gerenciada com parâmetros e tags especificados

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --license-type LicenseIncluded --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --capacity 8 --storage 32GB --edition GeneralPurpose --family Gen5 --tags tagName1=tagValue1 tagName2=tagValue2

Criar instância gerenciada com parâmetros especificados e redundância de armazenamento de backup especificada

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --license-type LicenseIncluded --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --capacity 8 --storage 32GB --edition GeneralPurpose --family Gen5 --backup-storage-redundancy Local

Criar uma instância gerenciada com configuração de manutenção

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} -m SQL_{Region}_{MaintenanceConfigName}

Criar uma instância gerenciada com a Entidade de Serviço habilitada

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --service-principal-type SystemAssigned

Crie uma instância gerenciada sem o SQL Admin, com o AAD admin e o AD Only habilitados

az sql mi create --enable-ad-only-auth --external-admin-principal-type User --external-admin-name myUserName --external-admin-sid c5e964e2-6bb2-2222-1111-3b16ec0e1234 -g myResourceGroup -n miName --subnet /subscriptions/78975f9f-2222-1111-1111-29c42ac70000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet-test/subnets/ManagedInstance

Crie uma instância gerenciada sem SQL Admin, com AD admin, AD Only habilitado, User ManagedIdenties e Identity Type é SystemAssigned,UserAssigned.

az sql mi create --enable-ad-only-auth --external-admin-principal-type User --external-admin-name myUserName \ --external-admin-sid c5e964e2-6bb2-1111-1111-3b16ec0e1234 -g myResourceGroup -n myServer -i \ --user-assigned-identity-id /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --identity-type SystemAssigned,UserAssigned --pid /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --subnet /subscriptions/78975f9f-2222-1111-1111-29c42ac70000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet-test/subnets/ManagedInstance

Crie uma instância gerenciada sem SQL Admin, com AD admin, AD Only habilitado, User ManagedIdenties e Identity Type é UserAssigned.

az sql mi create --enable-ad-only-auth --external-admin-principal-type User --external-admin-name myUserName \ --external-admin-sid c5e964e2-6bb2-1111-1111-3b16ec0e1234 -g myResourceGroup -n myServer -i \ --user-assigned-identity-id /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --identity-type UserAssigned --pid /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --subnet /subscriptions/78975f9f-2222-1111-1111-29c42ac70000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet-test/subnets/ManagedInstance

Criar instância gerenciada com redundância de zona habilitada

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} -z

Criar instância gerenciada com redundância de zona explicitamente desabilitada

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} -z false

Criar instância gerenciada com nome do pool de instâncias

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --instance-pool-name myinstancepool

Criar instância gerenciada com formato de banco de dados e modelo de preços

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --database-format AlwaysUpToDate --pricing-model Regular

Criar instância gerenciada com parceiro de zona dns

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --dns-zone-partner dns

Criar instância gerenciada que usa o modo de metadados de autenticação do Windows

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --am Windows

Criar instância gerenciada GPv2 com limite de IOPS especificado

az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p mypassword --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} -e GeneralPurpose --gpv2 true -f Gen8IH -c 4 --storage 256GB --iops 3000

Parâmetros Obrigatórios

--name -n

O nome da instância gerenciada.

--resource-group -g

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

--subnet

Nome ou ID da sub-rede que permite o acesso a uma Instância Gerenciada SQL do Azure. Se o nome da sub-rede for fornecido, --vnet-name deverá ser fornecido.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--admin-password -p

A senha de login do administrador (necessária para a criação de instância gerenciada).

--admin-user -u

Nome de usuário do administrador para a instância gerenciada. Só pode ser especificado quando a instância gerenciada está sendo criada (e é necessária para a criação).

--am --authentication-metadata

Metadados preferenciais a serem usados para autenticação de usuários locais sincronizados. O padrão é AzureAD.

Propriedade Valor
Valores aceites: AzureAD, Paired, Windows
--assign-identity -i

Gere e atribua uma Identidade do Ative Directory do Azure para esta instância gerenciada para uso com serviços de gerenciamento de chaves, como o Azure KeyVault.

Propriedade Valor
Default value: False
--backup-storage-redundancy --bsr

Redundância de armazenamento de backup usada para armazenar backups. Os valores permitidos incluem: Local, Zone, Geo, GeoZone.

--capacity -c

A capacidade da instância gerenciada em número inteiro de vcores.

Propriedade Valor
Parameter group: Performance Level (components) Arguments
--collation

O agrupamento da instância gerenciada.

--database-format

Formato de banco de dados de instância gerenciada específico para o SQL. Os valores permitidos incluem: AlwaysUpToDate, SQLServer2022.

Propriedade Valor
Valores aceites: AlwaysUpToDate, SQLServer2022
--dns-zone-partner

A ID do recurso da Instância Gerenciada do parceiro para herdar a propriedade DnsZone para a criação da Instância Gerenciada.

--edition --tier -e

O componente de edição do sku. Os valores permitidos incluem: GeneralPurpose, BusinessCritical.

Propriedade Valor
Parameter group: Performance Level (components) Arguments
--enable-ad-only-auth

Habilite a Autenticação Apenas do Ative Directory do Azure para este servidor.

Propriedade Valor
Default value: False
--external-admin-name

Nome para exibição do usuário, grupo ou aplicativo administrador do Azure AD.

--external-admin-principal-type

Utilizador, Grupo ou Aplicação.

--external-admin-sid

A ID exclusiva do administrador do Azure AD. ID do objeto para usuário ou grupo, ID do cliente para aplicativos.

--family -f

O componente de geração de computação do sku. Os valores permitidos incluem: Gen4, Gen5.

Propriedade Valor
Parameter group: Performance Level (components) Arguments
--gpv2

Se esta é ou não uma variante GPv2 da edição de uso geral.

Propriedade Valor
Valores aceites: false, true
--identity-type -t

Tipo de identidade a utilizar. Os valores possíveis são SystemAsssigned, UserAssigned, SystemAssignedUserAssigned e None.

Propriedade Valor
Valores aceites: None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned
--instance-pool-name

Nome do pool de instâncias onde a instância gerenciada será colocada.

--iops

As iops de armazenamento da instância gerenciada. As iops de armazenamento podem ser especificadas em incrementos de 1.

--key-id -k

O URI do cofre de chaves para criptografia.

--license-type

O tipo de licença a ser aplicado para esta instância gerenciada.

Propriedade Valor
Valores aceites: BasePrice, LicenseIncluded
--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--maint-config-id -m

Atribua a configuração de manutenção a esta instância gerenciada.

--minimal-tls-version
Pré-visualizar

A versão TLS mínima imposta pela instância gerenciada para conexões de entrada.

Propriedade Valor
Valores aceites: 1.0, 1.1, 1.2, None
--no-wait

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

Propriedade Valor
Default value: False
--pid --primary-user-assigned-identity-id

A ID da identidade gerenciada pelo usuário principal.

--pricing-model

Modelo de precificação de instância gerenciada. Os valores permitidos incluem: Regular, Freemium.

Propriedade Valor
Valores aceites: Freemium, Regular
--proxy-override

O tipo de conexão usado para se conectar à instância.

Propriedade Valor
Valores aceites: Default, Proxy, Redirect
--public-data-endpoint-enabled

Se o ponto de extremidade de dados públicos está habilitado ou não para a instância.

Propriedade Valor
Valores aceites: false, true
--service-principal-type

Tipo de entidade de serviço a ser usada para esta instância gerenciada. Os valores possíveis são SystemAssigned e None.

Propriedade Valor
Valores aceites: None, SystemAssigned
--storage

O tamanho do armazenamento da instância gerenciada. O tamanho do armazenamento deve ser especificado em incrementos de 32 GB.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--timezone-id

O id de fuso horário para a instância a ser definida. Uma lista de ids de fuso horário é exposta através da visualização sys.time_zone_info (Transact-SQL).

--user-assigned-identity-id -a

Gere e atribua uma UMI (User Managed Identity) para este servidor.

--vnet-name

O nome da rede virtual.

--yes -y

Não solicite confirmação.

Propriedade Valor
Default value: False
--zone-redundant -z

Especifica se a redundância de zona deve ser habilitada. O padrão é true se nenhum valor for especificado.

Propriedade Valor
Valores aceites: false, true
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Output format.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Default value: False

az sql mi delete

Exclua uma instância gerenciada.

az sql mi delete [--ids]
                 [--name]
                 [--no-wait]
                 [--resource-group]
                 [--subscription]
                 [--yes]

Exemplos

Excluir uma instância gerenciada

az sql mi delete -g mygroup -n myinstance --yes

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Propriedade Valor
Parameter group: Resource Id Arguments
--name -n

O nome da instância gerenciada.

Propriedade Valor
Parameter group: Resource Id Arguments
--no-wait

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

Propriedade Valor
Default value: False
--resource-group -g

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

Propriedade Valor
Parameter group: Resource Id Arguments
--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Output format.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Propriedade Valor
Default value: False

az sql mi failover

Failover de uma instância gerenciada.

az sql mi failover [--ids]
                   [--name]
                   [--no-wait]
                   [--replica-type]
                   [--resource-group]
                   [--subscription]

Exemplos

Failover de uma réplica primária de instância gerenciada

az sql mi failover -g mygroup -n myinstance

Failover de uma réplica de instância gerenciada legível

az sql mi failover -g mygroup -n myinstance --replica-type ReadableSecondary

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Propriedade Valor
Parameter group: Resource Id Arguments
--name -n

O nome da instância gerenciada.

Propriedade Valor
Parameter group: Resource Id Arguments
--no-wait

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

Propriedade Valor
Default value: False
--replica-type

O tipo de réplica a ser submetida a failover. Os valores conhecidos são: "Primário" e "LegívelSecundário". O valor padrão é Nenhum.

--resource-group -g

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

Propriedade Valor
Parameter group: Resource Id Arguments
--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Output format.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Propriedade Valor
Default value: False

az sql mi list

Listar instâncias gerenciadas disponíveis.

az sql mi list [--expand-ad-admin]
               [--resource-group]

Exemplos

Liste todas as instâncias gerenciadas na assinatura atual.

az sql mi list

Liste todas as instâncias gerenciadas em um grupo de recursos.

az sql mi list -g mygroup

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--expand-ad-admin

Expanda o Administrador do Ative Directory para o servidor.

Propriedade Valor
Default value: False
--resource-group -g

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Output format.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propriedade Valor
Default value: False

az sql mi refresh-external-governance-status

Atualize o status de habilitação de governança externa.

az sql mi refresh-external-governance-status [--ids]
                                             [--managed-instance-name --mi]
                                             [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                             [--resource-group]
                                             [--subscription]

Exemplos

Atualizar o status da governança externa em MI específicos

az sql mi refresh-external-governance-status --managed-instance-name managedInstance -g resourceGroup1 --subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Propriedade Valor
Parameter group: Resource Id Arguments
--managed-instance-name --mi

O nome da instância gerenciada.

Propriedade Valor
Parameter group: Resource Id Arguments
--no-wait

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

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

O nome do grupo de recursos.

Propriedade Valor
Parameter group: Resource Id Arguments
--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Output format.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Propriedade Valor
Default value: False

az sql mi show

Obtenha os detalhes de uma instância gerenciada.

az sql mi show [--expand-ad-admin]
               [--ids]
               [--name]
               [--resource-group]
               [--subscription]

Exemplos

Obter os detalhes de uma instância gerenciada

az sql mi show -g mygroup -n myinstance

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--expand-ad-admin

Expanda o Administrador do Ative Directory para o servidor.

Propriedade Valor
Default value: False
--ids

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

Propriedade Valor
Parameter group: Resource Id Arguments
--name -n

O nome da instância gerenciada.

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Parameter group: Resource Id Arguments
--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Output format.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Propriedade Valor
Default value: False

az sql mi start

Inicie a instância gerenciada.

az sql mi start [--ids]
                [--managed-instance --mi]
                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                [--resource-group]
                [--subscription]

Exemplos

Inicie uma instância gerenciada.

az sql mi start --ids resourceId
az sql mi start --mi miName -g resourceGroup --subscription subscription

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Propriedade Valor
Parameter group: Resource Id Arguments
--managed-instance --mi

O nome da instância gerenciada.

Propriedade Valor
Parameter group: Resource Id Arguments
--no-wait

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

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

Nome do grupo de recursos.

Propriedade Valor
Parameter group: Resource Id Arguments
--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Output format.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Propriedade Valor
Default value: False

az sql mi stop

Pare a instância gerenciada.

az sql mi stop [--ids]
               [--managed-instance --mi]
               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
               [--resource-group]
               [--subscription]

Exemplos

Pare uma instância gerenciada.

az sql mi stop --ids resourceId
az sql mi stop --mi miName -g resourceGroup --subscription subscription

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Propriedade Valor
Parameter group: Resource Id Arguments
--managed-instance --mi

O nome da instância gerenciada.

Propriedade Valor
Parameter group: Resource Id Arguments
--no-wait

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

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

Nome do grupo de recursos.

Propriedade Valor
Parameter group: Resource Id Arguments
--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Output format.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Propriedade Valor
Default value: False

az sql mi update

Atualize uma instância gerenciada.

az sql mi update [--add]
                 [--admin-password]
                 [--am --authentication-metadata {AzureAD, Paired, Windows}]
                 [--assign-identity]
                 [--backup-storage-redundancy --bsr]
                 [--capacity]
                 [--database-format {AlwaysUpToDate, SQLServer2022}]
                 [--edition --tier]
                 [--family]
                 [--force-string]
                 [--gpv2 {false, true}]
                 [--identity-type {None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned}]
                 [--ids]
                 [--instance-pool-name]
                 [--iops]
                 [--key-id]
                 [--license-type {BasePrice, LicenseIncluded}]
                 [--maint-config-id]
                 [--minimal-tls-version {1.0, 1.1, 1.2, None}]
                 [--name]
                 [--no-wait]
                 [--pid --primary-user-assigned-identity-id]
                 [--pricing-model {Freemium, Regular}]
                 [--proxy-override {Default, Proxy, Redirect}]
                 [--public-data-endpoint-enabled {false, true}]
                 [--remove]
                 [--resource-group]
                 [--service-principal-type {None, SystemAssigned}]
                 [--set]
                 [--storage]
                 [--subnet]
                 [--subscription]
                 [--tags]
                 [--user-assigned-identity-id]
                 [--vnet-name]
                 [--yes]
                 [--zone-redundant {false, true}]

Exemplos

Atualiza um mi com parâmetros especificados e com identidade

az sql mi update -g mygroup -n myinstance -i -p mypassword --license-type mylicensetype --capacity vcorecapacity --storage storagesize

Atualizar mi edition e família de hardware

az sql mi update -g mygroup -n myinstance --tier GeneralPurpose --family Gen5

Adicione ou atualize uma tag.

az sql mi update -g mygroup -n myinstance --set tags.tagName=tagValue

Remova uma etiqueta.

az sql mi update -g mygroup -n myinstance --remove tags.tagName

Atualize uma instância gerenciada. (autogenerated)

az sql mi update --name myinstance --proxy-override Default --resource-group mygroup --subscription MySubscription

Atualize uma instância gerenciada. (autogenerated)

az sql mi update --name myinstance --public-data-endpoint-enabled true --resource-group mygroup --subscription MySubscription

Atualizar uma instância gerenciada com configuração de manutenção

az sql mi update -g mygroup -n myinstance -m SQL_{Region}_{MaintenanceConfigName}

Remover a configuração de manutenção da instância gerenciada

az sql mi update -g mygroup -n myinstance -m SQL_Default

Atualizar uma instância gerenciada com a entidade de serviço

az sql mi update -g mygroup -n myinstance --service-principal-type SystemAssigned

Atualize uma instância gerenciada com Identidades gerenciadas pelo usuário e o tipo de identidade é SystemAssigned,UserAssigned.

az sql mi update -g myResourceGroup -n myServer -i \ --user-assigned-identity-id /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --identity-type SystemAssigned,UserAssigned --pid /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi

Atualizar uma instância gerenciada com Identidades gerenciadas pelo usuário e Tipo de identidade é UserAssigned

az sql mi update -g myResourceGroup -n myServer -i \ --user-assigned-identity-id /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --identity-type UserAssigned --pid /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi

Mover instância gerenciada para outra sub-rede

az sql mi update -g myResourceGroup -n myServer -i \ --subnet /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mysubnet \

Atualizar redundância de armazenamento de backup mi

az sql mi update -g mygroup -n myinstance --bsr Local

Habilitar redundância de zona em uma instância gerenciada

az sql mi update -g mygroup -n myinstance -z

Mover instância gerenciada para pool de instâncias

az sql mi update -g mygroup -n myinstance --instance-pool-name myinstancepool

Mover instância gerenciada para fora do pool de instâncias

az sql mi update -g mygroup -n myinstance --remove instancePoolId --capacity vcorecapacity

Atualizar o formato e o modelo de preços do meu banco de dados

az sql mi update -g mygroup -n myinstance --database-format AlwaysUpToDate --pricing-model Regular

Atualizar instância gerenciada para usar o modo de metadados de autenticação do Windows

az sql mi update -g mygroup -n myinstance --am Windows

Atualizar instância gerenciada para GPv2 com limite de IOPS especificado

az sql mi update -g mygroup -n myinstance -e GeneralPurpose --gpv2 true --iops 3000

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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 or JSON string>.

Propriedade Valor
Parameter group: Generic Update Arguments
Default value: []
--admin-password -p

A senha de login do administrador (necessária para a criação de instância gerenciada).

--am --authentication-metadata

Metadados preferenciais a serem usados para autenticação de usuários locais sincronizados. O padrão é AzureAD.

Propriedade Valor
Valores aceites: AzureAD, Paired, Windows
--assign-identity -i

Gere e atribua uma Identidade do Ative Directory do Azure para esta instância gerenciada para uso com serviços de gerenciamento de chaves, como o Azure KeyVault. Se a identidade já estiver atribuída - não faça nada.

Propriedade Valor
Default value: False
--backup-storage-redundancy --bsr

Redundância de armazenamento de backup usada para armazenar backups. Os valores permitidos incluem: Local, Zone, Geo, GeoZone.

--capacity -c

A capacidade da instância gerenciada em número inteiro de vcores.

Propriedade Valor
Parameter group: Performance Level (components) Arguments
--database-format

Formato de banco de dados de instância gerenciada específico para o SQL. Os valores permitidos incluem: AlwaysUpToDate, SQLServer2022.

Propriedade Valor
Valores aceites: AlwaysUpToDate, SQLServer2022
--edition --tier -e

O componente de edição do sku. Os valores permitidos incluem: GeneralPurpose, BusinessCritical.

Propriedade Valor
Parameter group: Performance Level (components) Arguments
--family -f

O componente de geração de computação do sku. Os valores permitidos incluem: Gen4, Gen5.

Propriedade Valor
Parameter group: Performance Level (components) Arguments
--force-string

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

Propriedade Valor
Parameter group: Generic Update Arguments
Default value: False
--gpv2

Se esta é ou não uma variante GPv2 da edição de uso geral.

Propriedade Valor
Valores aceites: false, true
--identity-type -t

Tipo de identidade a utilizar. Os valores possíveis são SystemAsssigned, UserAssigned, SystemAssignedUserAssigned e None.

Propriedade Valor
Valores aceites: None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned
--ids

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

Propriedade Valor
Parameter group: Resource Id Arguments
--instance-pool-name

Nome do pool de instâncias onde a instância gerenciada será colocada.

--iops

As iops de armazenamento da instância gerenciada. As iops de armazenamento podem ser especificadas em incrementos de 1.

--key-id -k

O URI do cofre de chaves para criptografia.

--license-type

O tipo de licença a ser aplicado para esta instância gerenciada.

Propriedade Valor
Valores aceites: BasePrice, LicenseIncluded
--maint-config-id -m

Altere a configuração de manutenção para esta instância gerenciada.

--minimal-tls-version
Pré-visualizar

A versão TLS mínima imposta pela instância gerenciada para conexões de entrada.

Propriedade Valor
Valores aceites: 1.0, 1.1, 1.2, None
--name -n

O nome da instância gerenciada.

Propriedade Valor
Parameter group: Resource Id Arguments
--no-wait

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

Propriedade Valor
Default value: False
--pid --primary-user-assigned-identity-id

A ID da identidade gerenciada pelo usuário principal.

--pricing-model

Modelo de precificação de instância gerenciada. Os valores permitidos incluem: Regular, Freemium.

Propriedade Valor
Valores aceites: Freemium, Regular
--proxy-override

O tipo de conexão usado para se conectar à instância.

Propriedade Valor
Valores aceites: Default, Proxy, Redirect
--public-data-endpoint-enabled

Se o ponto de extremidade de dados públicos está habilitado ou não para a instância.

Propriedade Valor
Valores aceites: false, true
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.

Propriedade Valor
Parameter group: Generic Update Arguments
Default value: []
--resource-group -g

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

Propriedade Valor
Parameter group: Resource Id Arguments
--service-principal-type

Tipo de entidade de serviço a ser usada para esta instância gerenciada. Os valores possíveis são SystemAssigned e None.

Propriedade Valor
Valores aceites: None, SystemAssigned
--set

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

Propriedade Valor
Parameter group: Generic Update Arguments
Default value: []
--storage

O tamanho do armazenamento da instância gerenciada. O tamanho do armazenamento deve ser especificado em incrementos de 32 GB.

--subnet

Nome ou ID da sub-rede que permite o acesso a uma Instância Gerenciada SQL do Azure. Se o nome da sub-rede for fornecido, --vnet-name deverá ser fornecido.

--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--user-assigned-identity-id -a

Gere e atribua uma UMI (User Managed Identity) para este servidor.

--vnet-name

O nome da rede virtual.

--yes -y

Não solicite confirmação.

Propriedade Valor
Default value: False
--zone-redundant -z

Especifica se a redundância de zona deve ser habilitada. O padrão é true se nenhum valor for especificado.

Propriedade Valor
Valores aceites: false, true
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Output format.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Propriedade Valor
Default value: False