Set-AzSqlServerActiveDirectoryAdministrator

  • Referencia
Módulo:
Az.Sql

Aprovisiona un administrador de Microsoft Entra para SQL Server.

Sintaxis

Set-AzSqlServerActiveDirectoryAdministrator
   [-DisplayName] <String>
   [[-ObjectId] <Guid>]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzSqlServerActiveDirectoryAdministrator aprovisiona un administrador de Microsoft Entra para AzureSQL Server 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 Server:

  • Miembros nativos de Microsoft Entra ID
  • Miembros federados de Microsoft Entra ID
  • Miembros importados de otros Azure AD que son miembros nativos o federados
  • Los grupos de Microsoft Entra creados como cuentas de Microsoft de grupos de seguridad, como los de la Outlook.com, Hotmail.com o dominios de 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 un servidor

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "DBAs"

ResourceGroupName ServerName DisplayName ObjectId IsAzureADOnlyAuthentication
----------------- ---------- ----------- -------- ---------------------------
ResourceGroup01   Server01   DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b False

Este comando aprovisiona un grupo de administradores de Microsoft Entra denominado DBAs para el servidor denominado Server01. Este servidor está asociado al grupo de recursos ResourceGroup01.

Ejemplo 2: Aprovisionamiento de un usuario administrador para un servidor

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "David Chew"

ResourceGroupName ServerName DisplayName ObjectId IsAzureADOnlyAuthentication
----------------- ---------- ----------- -------- 
resourcegroup01   server01   David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9 False

Este comando aprovisiona un usuario de Microsoft Entra como administrador para el servidor denominado Server01.

Ejemplo 3: Aprovisionamiento de un grupo de administradores especificando su identificador

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "DBAs" -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"

ResourceGroupName ServerName DisplayName ObjectId IsAzureADOnlyAuthentication 
----------------- ---------- ----------- -------- 
ResourceGroup01   Server01   DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b False

Este comando aprovisiona un grupo de administradores de Microsoft Entra denominado DBAs para el servidor denominado Server01. El comando especifica un identificador para el parámetro ObjectId . Esto garantiza que el comando se realice correctamente incluso si el nombre para mostrar del grupo no es único.

Parámetros

-Confirm

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

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan 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 administrador de Microsoft Entra que aprovisiona este cmdlet.

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

-ObjectId

Especifica el identificador único del administrador de Microsoft Entra que este cmdlet aprovisiona. Si el nombre para mostrar no es único, debe especificar un valor para este parámetro.

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

-ResourceGroupName

Especifica el nombre del grupo de recursos al que se asigna el servidor.

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

-ServerName

Especifica el nombre de SQL Server para el que este cmdlet aprovisiona un administrador.

Tipo:String
Posición:1
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:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Guid

Salidas

AzureSqlServerActiveDirectoryAdministratorModel