Partilhar via

Set-AzureRmSqlServerActiveDirectoryAdministrator

  • Referência
Módulo:
AzureRM.Sql

Provisiona um administrador do Microsoft Entra para o SQL Server.

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

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

Description

O cmdlet Set-AzureRmSqlServerActiveDirectoryAdministrator provisiona um administrador do Microsoft Entra para AzureSQL Server na assinatura atual. Você pode provisionar apenas um administrador de cada vez. Os seguintes membros do Microsoft Entra ID podem ser provisionados como um administrador do SQL Server:

  • Membros nativos do Microsoft Entra ID
  • Membros federados do Microsoft Entra ID
  • Membros importados de outros Azure ADs que são membros nativos ou federados
  • Grupos do Microsoft Entra criados como grupos de segurança As contas da Microsoft, como as dos domínios Outlook.com, Hotmail.com ou Live.com, não são suportadas como administradores. Outras contas de convidado, como as dos domínios Gmail.com ou Yahoo.com, não são suportadas como administradores. Recomendamos que você provisione um grupo dedicado do Microsoft Entra como administrador.

Exemplos

Exemplo 1: Provisionar um grupo de administradores para um 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 provisiona um grupo de administradores do Microsoft Entra chamado DBAs para o servidor chamado Server01. Este servidor está associado ao grupo de recursos ResourceGroup01.

Exemplo 2: Provisionar um usuário administrador para um 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 provisiona um usuário do Microsoft Entra como administrador para o servidor chamado Server01.

Exemplo 3: Provisionar um grupo de administradores especificando sua ID

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 provisiona um grupo de administradores do Microsoft Entra chamado DBAs para o servidor chamado Server01. O comando especifica uma ID para o parâmetro ObjectId . Isso garante que o comando seja bem-sucedido mesmo que o nome para exibição do grupo não seja exclusivo.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DisplayName

Especifica o nome para exibição do administrador do Microsoft Entra que esse cmdlet provisiona.

Tipo:String
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ObjectId

Especifica a ID exclusiva do administrador do Microsoft Entra que esse cmdlet provisiona. Se o nome para exibição não for exclusivo, você deverá especificar um valor para esse parâmetro.

Tipo:Guid
Position:3
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

Especifica o nome do grupo de recursos ao qual o servidor está atribuído.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ServerName

Especifica o nome do SQL Server para o qual este cmdlet provisiona um administrador.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Guid

Saídas

AzureSqlServerActiveDirectoryAdministratorModel