Set-AzSqlInstanceActiveDirectoryAdministrator

Aprovisiona un administrador de Microsoft Entra para SQL Instancia administrada.

Syntax

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-AzSqlInstanceActiveDirectory Administración istrator 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

Objeto de instancia administrada que se va a usar.

Type:AzureSqlManagedInstanceModel
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstanceName

Nombre de sql Instancia administrada.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

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

Type:Guid
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Nombre del grupo de recursos.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Identificador de recurso de la instancia que se va a usar

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Guid

Salidas

AzureSqlInstanceActiveDirectoryAdministratorModel