Set-AzureRmSqlServerActiveDirectoryAdministrator
Provisiona um administrador do Microsoft Entra para SQL Server.
Aviso
O módulo do PowerShell do AzureRM foi oficialmente preterido em 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes 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 o AzureSQL Server na assinatura atual. Você pode provisionar apenas um administrador por 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 têm suporte 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 do 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 se o nome de exibição do grupo não for exclusivo.
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure
Tipo: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisplayName
Especifica o nome para exibição do administrador do Microsoft Entra provisionado por esse cmdlet.
Tipo: | String |
Cargo: | 2 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ObjectId
Especifica a ID exclusiva do administrador do Microsoft Entra provisionada por este cmdlet. Se o nome para exibição não for exclusivo, você deverá especificar um valor para esse parâmetro.
Tipo: | Guid |
Cargo: | 3 |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ResourceGroupName
Especifica o nome do grupo de recursos ao qual o servidor está atribuído.
Tipo: | String |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ServerName
Especifica o nome do SQL Server para o qual este cmdlet provisiona um administrador.
Tipo: | String |
Cargo: | 1 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
Saídas
AzureSqlServerActiveDirectoryAdministratorModel