Set-AzSqlInstanceActiveDirectoryAdministrator

  • Referencia
Módulo:
Az.Sql

Aprovisiona un administrador de Microsoft Entra para SQL Instancia administrada.

Sintaxis

Set-AzSqlInstanceActiveDirectoryAdministrator
   [-DisplayName] <String>
   [-ObjectId] <Guid>
   [-ResourceGroupName] <String>
   [-InstanceName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSqlInstanceActiveDirectoryAdministrator
   [-DisplayName] <String>
   [-ObjectId] <Guid>
   -InputObject <AzureSqlManagedInstanceModel>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSqlInstanceActiveDirectoryAdministrator
   [-DisplayName] <String>
   [-ObjectId] <Guid>
   [-ResourceId] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzSqlInstanceActiveDirectoryAdministrator aprovisiona un administrador de Microsoft Entra para AzureSQL Instancia administrada en la suscripción actual. Solo puede aprovisionar un administrador a la vez. Los siguientes miembros de Microsoft Entra ID se pueden aprovisionar como administrador de SQL Instancia administrada:

  • Miembros nativos de Microsoft Entra ID
  • Miembros federados de Microsoft Entra ID
  • Los grupos de Microsoft Entra creados como grupos de seguridad Miembros importados de otros Azure AD no se admiten como administradores. Las cuentas microsoft, como las de los dominios de Outlook.com, Hotmail.com o Live.com, no se admiten como administradores. Otras cuentas de invitado, como las de los dominios de Gmail.com o Yahoo.com, no se admiten como administradores. Se recomienda aprovisionar un grupo de Microsoft Entra dedicado como administrador.

Ejemplos

Ejemplo 1: Aprovisionamiento de un grupo de administradores para una instancia administrada asociada con el grupo de recursos

Set-AzSqlInstanceActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -InstanceName "ManagedInstance01" -DisplayName "DBAs" -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"

ResourceGroupName InstanceName      DisplayName ObjectId 
----------------- ----------------- ----------- -------- 
ResourceGroup01   ManagedInstance01 DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b

Este comando aprovisiona un grupo de administradores de Microsoft Entra denominado DBAs para la instancia administrada denominada ManagedInstance01. Este servidor está asociado al grupo de recursos ResourceGroup01.

Ejemplo 2: Aprovisionamiento de un usuario administrador mediante un objeto de instancia administrada

Get-AzSqlInstance -ResourceGroupName "ResourceGroup01" -InstanceName "ManagedInstance01" | Set-AzSqlInstanceActiveDirectoryAdministrator -DisplayName "David Chew" -ObjectId "11E95548-B179-4FE1-9AF4-ACA49D13ABB9"

ResourceGroupName InstanceName      DisplayName ObjectId 
----------------- ----------------- ----------- -------- 
Resourcegroup01   ManagedInstance01 David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9

Este comando aprovisiona un usuario de Microsoft Entra como administrador del objeto de instancia administrada.

Ejemplo 3: Aprovisionamiento de un administrador mediante el identificador de recursos de instancia administrada

Get-AzSqlInstance -ResourceId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/managedInstances/ManagedInstance01" | Set-AzSqlInstanceActiveDirectoryAdministrator -DisplayName "David Chew" -ObjectId "11E95548-B179-4FE1-9AF4-ACA49D13ABB9"

ResourceGroupName InstanceName      DisplayName ObjectId 
----------------- ----------------- ----------- -------- 
Resourcegroup01   ManagedInstance01 David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9

Este comando aprovisiona un usuario de Microsoft Entra como administrador mediante el identificador de recursos de instancia administrada.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisplayName

Especifica el nombre para mostrar del usuario o grupo para el que se van a conceder permisos. Este nombre para mostrar debe existir en el directorio activo asociado a la suscripción actual.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-InputObject

Objeto de instancia administrada que se va a usar.

Tipo:AzureSqlManagedInstanceModel
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-InstanceName

Nombre de sql Instancia administrada.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ObjectId

Especifica el identificador de objeto del usuario o grupo de Microsoft Entra ID para el que se van a conceder permisos.

Tipo:Guid
Posición:3
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResourceGroupName

Nombre del grupo de recursos.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResourceId

Identificador de recurso de la instancia que se va a usar

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Guid

Salidas

AzureSqlInstanceActiveDirectoryAdministratorModel