Compartir a través de


az sql mi

Administrar instancias administradas de SQL.

Comandos

Nombre Description Tipo Estado
az sql mi ad-admin

Administrar el administrador de Active Directory de una instancia administrada.

Core GA
az sql mi ad-admin create

Crea un nuevo administrador de Active Directory de instancia administrada.

Core GA
az sql mi ad-admin delete

Elimina un administrador de Active Directory de instancia administrada existente.

Core GA
az sql mi ad-admin list

Devuelve una lista de administradores de Active Directory de instancia administrada.

Core GA
az sql mi ad-admin update

Actualiza un administrador de Active Directory de instancia administrada existente.

Core GA
az sql mi ad-only-auth

Administre solo la configuración de Azure Active Directory de una Instancia administrada.

Core GA
az sql mi ad-only-auth disable

Deshabilite la autenticación solo de Azure Active Directory para este Instancia administrada.

Core GA
az sql mi ad-only-auth enable

Habilite la autenticación solo de Azure Active Directory para este Instancia administrada.

Core GA
az sql mi ad-only-auth get

Obtenga una propiedad de autenticación específica de Azure Active Directory.

Core GA
az sql mi advanced-threat-protection-setting

Administre la configuración de protección contra amenazas avanzada de una Instancia administrada de SQL.

Core GA
az sql mi advanced-threat-protection-setting show

Obtiene una configuración de protección contra amenazas avanzada.

Core GA
az sql mi advanced-threat-protection-setting update

Actualice la configuración de protección contra amenazas avanzada de sql Instancia administrada.

Core GA
az sql mi create

Cree una instancia administrada.

Core GA
az sql mi delete

Elimine una instancia administrada.

Core GA
az sql mi dtc

Comandos relacionados con la administración de DTC de instancia administrada.

Core GA
az sql mi dtc show

Obtiene la configuración de DTC de instancia administrada.

Core GA
az sql mi dtc update

Actualice la configuración de DTC de la instancia administrada.

Core GA
az sql mi dtc wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

Core GA
az sql mi endpoint-cert

Comandos de administración de certificados de punto de conexión.

Core GA
az sql mi endpoint-cert list

Enumera los certificados usados en los puntos de conexión de la instancia de destino.

Core GA
az sql mi endpoint-cert show

Obtenga un certificado usado en el punto de conexión con el identificador especificado.

Core GA
az sql mi failover

Conmutación por error de una instancia administrada.

Core GA
az sql mi key

Administrar las claves de una instancia de SQL.

Core GA
az sql mi key create

Crea una clave de instancia de SQL.

Core GA
az sql mi key delete

Elimina una clave de instancia de SQL.

Core GA
az sql mi key list

Obtiene una lista de claves de instancia administrada.

Core GA
az sql mi key show

Muestra una clave de instancia de SQL.

Core GA
az sql mi link

Comandos de administración de vínculos de instancia.

Core GA
az sql mi link create

Cree un vínculo de Instancia administrada entre Sql Local e Instancia administrada de Sql.

Core GA
az sql mi link delete

Quite un vínculo de Instancia administrada entre Sql Local e Instancia administrada de Sql.

Core GA
az sql mi link failover

Realiza el tipo de conmutación por error solicitado en este vínculo de Instancia administrada.

Core GA
az sql mi link list

Obtenga una lista de vínculos de Instancia administrada en la instancia.

Core GA
az sql mi link show

Obtenga información de vínculo de Instancia administrada.

Core GA
az sql mi link update

Actualice un modo de replicación de vínculo de Instancia administrada.

Core GA
az sql mi list

Enumere las instancias administradas disponibles.

Core GA
az sql mi op

Administrar operaciones en una instancia administrada.

Core GA
az sql mi op cancel

Cancela la operación asincrónica en la instancia administrada.

Core GA
az sql mi op list

Obtiene una lista de las operaciones realizadas en la instancia administrada.

Core GA
az sql mi op show

Obtiene una operación de administración en una instancia administrada.

Core GA
az sql mi partner-cert

Comandos de administración de certificados de confianza de servidor.

Core GA
az sql mi partner-cert create

Cargue un certificado de confianza de servidor desde el cuadro a Sql Instancia administrada.

Core GA
az sql mi partner-cert delete

Elimine un certificado de confianza de servidor que se cargó de box en Sql Instancia administrada.

Core GA
az sql mi partner-cert list

Obtenga una lista de certificados de confianza de servidor que se cargaron desde el cuadro en el Instancia administrada sql especificado.

Core GA
az sql mi partner-cert show

Obtenga un certificado de confianza de servidor que se cargó desde el cuadro a Sql Instancia administrada.

Core GA
az sql mi refresh-external-governance-status

Actualice el estado de habilitación de gobernanza externa.

Core GA
az sql mi server-configuration-option

Comandos de administración de opciones de configuración del servidor.

Core GA
az sql mi server-configuration-option list

Enumerar una lista de opciones de configuración del servidor de instancia administrada.

Core GA
az sql mi server-configuration-option set

Establezca la opción de configuración del servidor de instancia administrada.

Core GA
az sql mi server-configuration-option show

Obtenga la opción de configuración del servidor de instancia administrada.

Core GA
az sql mi server-configuration-option wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

Core GA
az sql mi show

Obtenga los detalles de una instancia administrada.

Core GA
az sql mi start

Inicie la instancia administrada.

Core GA
az sql mi start-stop-schedule

Administre la programación de detención de inicio de la instancia administrada.

Core GA
az sql mi start-stop-schedule create

Cree la programación Start/Stop de la instancia administrada.

Core GA
az sql mi start-stop-schedule delete

Elimine la programación start/Stop de la instancia administrada.

Core GA
az sql mi start-stop-schedule list

Enumere las programaciones de inicio y detención de la instancia administrada.

Core GA
az sql mi start-stop-schedule show

Obtenga la programación Start/Stop de la instancia administrada.

Core GA
az sql mi start-stop-schedule update

Actualice la programación Start/Stop de la instancia administrada.

Core GA
az sql mi stop

Detenga la instancia administrada.

Core GA
az sql mi tde-key

Administrar el protector de cifrado de una instancia de SQL.

Core GA
az sql mi tde-key set

Establece el protector de cifrado de la instancia de SQL.

Core GA
az sql mi tde-key show

Muestra un protector de cifrado de servidor.

Core GA
az sql mi update

Actualice una instancia administrada.

Core GA

az sql mi create

Cree una instancia administrada.

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

Ejemplos

Creación de una instancia administrada con un 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}

Creación de una instancia administrada con parámetros especificados y con identidad

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

Creación de una instancia administrada con parámetros y etiquetas 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

Creación de una instancia administrada con parámetros especificados y redundancia de almacenamiento de copia de seguridad 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

Creación de una instancia administrada con configuración de mantenimiento

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}

Creación de una instancia administrada con la entidad de servicio 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

Creación de una instancia administrada sin administrador de SQL, con el administrador de AAD y solo AD habilitado

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

Cree una instancia administrada sin administrador de SQL, con el administrador de AD, solo habilitado, ManagedIdenties de usuario y tipo de identidad es 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

Cree una instancia administrada sin administrador de SQL, con el administrador de AD, solo habilitado para AD, User ManagedIdenties e Identity Type es 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

Creación de una instancia administrada con redundancia 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

Creación de una instancia administrada con redundancia de zona deshabilitada explícitamente

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

Creación de una instancia administrada con el nombre del grupo de instancias

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

Creación de una instancia administrada con el formato de base de datos y el modelo de precios

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

Creación de una instancia administrada con el asociado 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

Creación de una instancia administrada que usa el modo de metadatos de autenticación de 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

Creación de una instancia administrada de GPv2 con el límite 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 requeridos

--name -n

Nombre de la instancia administrada.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subnet

Nombre o identificador de la subred que permite el acceso a una instancia administrada de Azure Sql. Si se proporciona el nombre de subred, se debe proporcionar --vnet-name.

Parámetros opcionales

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

La contraseña de inicio de sesión del administrador (creación necesaria de la instancia de formación).

--admin-user -u

Nombre de usuario del administrador para la instancia administrada. Canonly se especifica cuando se está creando la instancia administrada (y es necesaria para la creación).

--am --authentication-metadata

Metadatos preferidos que se usarán para la autenticación de usuarios locales sincronizados. El valor predeterminado es AzureAD.

Propiedad Valor
Valores aceptados: AzureAD, Paired, Windows
--assign-identity -i

Genere y asigne una identidad de Azure Active Directory para esta instancia administrada para su uso con servicios de administración de claves como Azure KeyVault.

Propiedad Valor
Valor predeterminado: False
--backup-storage-redundancy --bsr

Redundancia de almacenamiento de copia de seguridad usada para almacenar copias de seguridad. Entre los valores permitidos se incluyen: Local, Zone, Geo, GeoZone.

--capacity -c

Capacidad de la instancia administrada en número entero de vcores.

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

Intercalación de la instancia administrada.

--database-format

Formato de base de datos de Instancia administrada específico de SQL. Entre los valores permitidos se incluyen: AlwaysUpToDate, SQLServer2022.

Propiedad Valor
Valores aceptados: AlwaysUpToDate, SQLServer2022
--dns-zone-partner

Identificador de recurso de la instancia administrada del asociado para heredar la propiedad DnsZone de para la creación de Instancia administrada.

--edition --tier -e

Componente de edición de la SKU. Entre los valores permitidos se incluyen: GeneralPurpose, BusinessCritical.

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

Habilite la autenticación solo de Azure Active Directory para este servidor.

Propiedad Valor
Valor predeterminado: False
--external-admin-name

Nombre para mostrar del usuario, grupo o aplicación administrador de Azure AD.

--external-admin-principal-type

Usuario, grupo o aplicación.

--external-admin-sid

Identificador único del administrador de Azure AD. Id. de objeto para usuario o grupo, id. de cliente para aplicaciones.

--family -f

Componente de generación de proceso de la SKU. Entre los valores permitidos se incluyen: Gen4, Gen5.

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

Indica si se trata de una variante GPv2 de la edición De uso general.

Propiedad Valor
Valores aceptados: false, true
--identity-type -t

Tipo de identidad que se va a usar. Los valores posibles son SystemAsssigned,UserAssigned, SystemAssignedUserAssigned y None.

Propiedad Valor
Valores aceptados: None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned
--instance-pool-name

Nombre del grupo de instancias donde se colocará la instancia administrada.

--iops

Las iops de almacenamiento de la instancia administrada. Las iops de almacenamiento se pueden especificar en incrementos de 1.

--key-id -k

Identificador URI del almacén de claves para el cifrado.

--license-type

Tipo de licencia que se va a aplicar para esta instancia administrada.

Propiedad Valor
Valores aceptados: BasePrice, LicenseIncluded
--location -l

Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--maint-config-id -m

Asigne la configuración de mantenimiento a esta instancia administrada.

--minimal-tls-version
Vista previa

La versión mínima de TLS aplicada por la instancia administrada para las conexiones entrantes.

Propiedad Valor
Valores aceptados: 1.0, 1.1, 1.2, None
--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--pid --primary-user-assigned-identity-id

Identificador de la identidad administrada del usuario principal.

--pricing-model

Modelo de precios de Instancia administrada. Entre los valores permitidos se incluyen: Regular, Freemium.

Propiedad Valor
Valores aceptados: Freemium, Regular
--proxy-override

Tipo de conexión que se usa para conectarse a la instancia.

Propiedad Valor
Valores aceptados: Default, Proxy, Redirect
--public-data-endpoint-enabled

Indica si el punto de conexión de datos público está habilitado para la instancia de .

Propiedad Valor
Valores aceptados: false, true
--service-principal-type

Tipo de entidad de servicio que se va a usar para esta instancia administrada. Los valores posibles son SystemAssigned y None.

Propiedad Valor
Valores aceptados: None, SystemAssigned
--storage

Tamaño de almacenamiento de la instancia administrada. El tamaño de almacenamiento debe especificarse en incrementos de 32 GB.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--timezone-id

Identificador de zona horaria de la instancia que se va a establecer. Se expone una lista de identificadores de zona horaria a través de la vista sys.time_zone_info (Transact-SQL).

--user-assigned-identity-id -a

Genere y asigne una identidad administrada por el usuario (UMI) para este servidor.

--vnet-name

Nombre de la red virtual.

--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
--zone-redundant -z

Especifica si se va a habilitar la redundancia de zona. El valor predeterminado es true si no se especifica ningún valor.

Propiedad Valor
Valores aceptados: false, true
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az sql mi delete

Elimine una instancia administrada.

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

Ejemplos

Eliminación de una instancia administrada

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

Parámetros opcionales

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

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

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

Nombre de la instancia administrada.

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

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Parameter group: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

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

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az sql mi failover

Conmutación por error de una instancia administrada.

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

Ejemplos

Conmutación por error de una réplica principal de instancia administrada

az sql mi failover -g mygroup -n myinstance

Conmutación por error de una réplica secodary legible de una instancia administrada

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

Parámetros opcionales

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

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

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

Nombre de la instancia administrada.

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

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--replica-type

Tipo de réplica que se va a conmutar por error. Los valores conocidos son: "Primary" y "ReadableSecondary". El valor predeterminado es None.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Parameter group: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az sql mi list

Enumere las instancias administradas disponibles.

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

Ejemplos

Enumere todas las instancias administradas de la suscripción actual.

az sql mi list

Enumere todas las instancias administradas de un grupo de recursos.

az sql mi list -g mygroup

Parámetros opcionales

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 el administrador de Active Directory para el servidor.

Propiedad Valor
Valor predeterminado: False
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az sql mi refresh-external-governance-status

Actualice el estado de habilitación de gobernanza 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]

Ejemplos

Actualización del estado de gobernanza externa en mi específica

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

Parámetros opcionales

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

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

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

Nombre de la instancia administrada.

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

No espere a que finalice la operación de ejecución prolongada.

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

Nombre del grupo de recursos.

Propiedad Valor
Parameter group: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az sql mi show

Obtenga los detalles de una instancia administrada.

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

Ejemplos

Obtención de los detalles de una instancia administrada

az sql mi show -g mygroup -n myinstance

Parámetros opcionales

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 el administrador de Active Directory para el servidor.

Propiedad Valor
Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

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

Nombre de la instancia administrada.

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

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Parameter group: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az sql mi start

Inicie la instancia administrada.

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

Ejemplos

Inicie una instancia administrada.

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

Parámetros opcionales

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

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

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

Nombre de la instancia administrada.

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

No espere a que finalice la operación de ejecución prolongada.

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

Nombre del grupo de recursos.

Propiedad Valor
Parameter group: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az sql mi stop

Detenga la instancia administrada.

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

Ejemplos

Detenga una instancia administrada.

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

Parámetros opcionales

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

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

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

Nombre de la instancia administrada.

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

No espere a que finalice la operación de ejecución prolongada.

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

Nombre del grupo de recursos.

Propiedad Valor
Parameter group: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Parameter group: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az sql mi update

Actualice una instancia administrada.

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

Ejemplos

Actualiza un mi con los parámetros especificados y con la identidad

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

Actualizar mi edition y familia de hardware

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

Agregue o actualice una etiqueta.

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

Quite una etiqueta.

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

Actualice una instancia administrada. (autogenerated)

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

Actualice una instancia administrada. (autogenerated)

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

Actualización de una instancia administrada con configuración de mantenimiento

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

Eliminación de la configuración de mantenimiento de la instancia administrada

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

Actualización de una instancia administrada con la entidad de servicio

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

Actualizar una instancia administrada con identificadores administrados por el usuario y el tipo de identidad es 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

La actualización de una instancia administrada con identificadores administrados por el usuario y el tipo de identidad es 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

Traslado de una instancia administrada a otra subred

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 \

Actualización de la redundancia del almacenamiento de copia de seguridad mi

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

Habilitación de la redundancia de zona en una instancia administrada

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

Traslado de una instancia administrada al grupo de instancias

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

Mover la instancia administrada fuera del grupo de instancias

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

Actualizar el formato de base de datos mi y el modelo de precios

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

Actualización de la instancia administrada para usar el modo de metadatos de autenticación de Windows

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

Actualización de la instancia administrada a GPv2 con el límite de IOPS especificado

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

Parámetros opcionales

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

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Propiedad Valor
Parameter group: Generic Update Arguments
Valor predeterminado: []
--admin-password -p

La contraseña de inicio de sesión del administrador (creación necesaria de la instancia de formación).

--am --authentication-metadata

Metadatos preferidos que se usarán para la autenticación de usuarios locales sincronizados. El valor predeterminado es AzureAD.

Propiedad Valor
Valores aceptados: AzureAD, Paired, Windows
--assign-identity -i

Genere y asigne una identidad de Azure Active Directory para esta instancia administrada para su uso con servicios de administración de claves como Azure KeyVault. Si la identidad ya está asignada, no haga nada.

Propiedad Valor
Valor predeterminado: False
--backup-storage-redundancy --bsr

Redundancia de almacenamiento de copia de seguridad usada para almacenar copias de seguridad. Entre los valores permitidos se incluyen: Local, Zone, Geo, GeoZone.

--capacity -c

Capacidad de la instancia administrada en número entero de vcores.

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

Formato de base de datos de Instancia administrada específico de SQL. Entre los valores permitidos se incluyen: AlwaysUpToDate, SQLServer2022.

Propiedad Valor
Valores aceptados: AlwaysUpToDate, SQLServer2022
--edition --tier -e

Componente de edición de la SKU. Entre los valores permitidos se incluyen: GeneralPurpose, BusinessCritical.

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

Componente de generación de proceso de la SKU. Entre los valores permitidos se incluyen: Gen4, Gen5.

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

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Propiedad Valor
Parameter group: Generic Update Arguments
Valor predeterminado: False
--gpv2

Indica si se trata de una variante GPv2 de la edición De uso general.

Propiedad Valor
Valores aceptados: false, true
--identity-type -t

Tipo de identidad que se va a usar. Los valores posibles son SystemAsssigned,UserAssigned, SystemAssignedUserAssigned y None.

Propiedad Valor
Valores aceptados: None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

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

Nombre del grupo de instancias donde se colocará la instancia administrada.

--iops

Las iops de almacenamiento de la instancia administrada. Las iops de almacenamiento se pueden especificar en incrementos de 1.

--key-id -k

Identificador URI del almacén de claves para el cifrado.

--license-type

Tipo de licencia que se va a aplicar para esta instancia administrada.

Propiedad Valor
Valores aceptados: BasePrice, LicenseIncluded
--maint-config-id -m

Cambie la configuración de mantenimiento de esta instancia administrada.

--minimal-tls-version
Vista previa

La versión mínima de TLS aplicada por la instancia administrada para las conexiones entrantes.

Propiedad Valor
Valores aceptados: 1.0, 1.1, 1.2, None
--name -n

Nombre de la instancia administrada.

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

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--pid --primary-user-assigned-identity-id

Identificador de la identidad administrada del usuario principal.

--pricing-model

Modelo de precios de Instancia administrada. Entre los valores permitidos se incluyen: Regular, Freemium.

Propiedad Valor
Valores aceptados: Freemium, Regular
--proxy-override

Tipo de conexión que se usa para conectarse a la instancia.

Propiedad Valor
Valores aceptados: Default, Proxy, Redirect
--public-data-endpoint-enabled

Indica si el punto de conexión de datos público está habilitado para la instancia de .

Propiedad Valor
Valores aceptados: false, true
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Propiedad Valor
Parameter group: Generic Update Arguments
Valor predeterminado: []
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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

Tipo de entidad de servicio que se va a usar para esta instancia administrada. Los valores posibles son SystemAssigned y None.

Propiedad Valor
Valores aceptados: None, SystemAssigned
--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Propiedad Valor
Parameter group: Generic Update Arguments
Valor predeterminado: []
--storage

Tamaño de almacenamiento de la instancia administrada. El tamaño de almacenamiento debe especificarse en incrementos de 32 GB.

--subnet

Nombre o identificador de la subred que permite el acceso a una instancia administrada de Azure Sql. Si se proporciona el nombre de subred, se debe proporcionar --vnet-name.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Parameter group: Resource Id Arguments
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--user-assigned-identity-id -a

Genere y asigne una identidad administrada por el usuario (UMI) para este servidor.

--vnet-name

Nombre de la red virtual.

--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
--zone-redundant -z

Especifica si se va a habilitar la redundancia de zona. El valor predeterminado es true si no se especifica ningún valor.

Propiedad Valor
Valores aceptados: false, true
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Output format.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False