Set-AzureRmSqlServerActiveDirectoryAdministrator

  • Referencia
Módulo:
AzureRM.Sql

Aprovisiona un administrador de Microsoft Entra para SQL Server.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

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

Description

El cmdlet Set-AzureRmSqlServerActiveDirectory Administración istrator 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

PS C:\>Set-AzureRmSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "DBAs" 
ResourceGroupName ServerName DisplayName ObjectId 
----------------- ---------- ----------- -------- 
ResourceGroup01   Server01   DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b

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

PS C:\>Set-AzureRmSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "David Chew"
ResourceGroupName ServerName DisplayName ObjectId 
----------------- ---------- ----------- -------- 
resourcegroup01   server01   David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9

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

PS C:\>Set-AzureRmSqlServerActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DisplayName "DBAs" -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"
ResourceGroupName ServerName DisplayName ObjectId 
----------------- ---------- ----------- -------- 
ResourceGroup01   Server01   DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b

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.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Especifica el nombre para mostrar del administrador de Microsoft Entra que aprovisiona este cmdlet.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-ResourceGroupName

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

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

-ServerName

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

Type:String
Position:1
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:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Guid

Salidas

AzureSqlServerActiveDirectoryAdministratorModel