Leer en inglés

Compartir a través de

Set-AzSqlServerActiveDirectoryAdministrator

  • Referencia
Módulo:
Az.Sql

Aprovisiona un administrador de Microsoft Entra para SQL Server.

Sintaxis

PowerShell 
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

PowerShell 
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

PowerShell 
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

PowerShell 
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 pide 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 el cmdlet se ejecuta. 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

Salidas