Поделиться через

Set-AzSqlServerActiveDirectoryAdministrator

Модуль:
Az.Sql Module

Подготавливает администратора Microsoft Entra для SQL Server.

Синтаксис

Default (По умолчанию) 

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

Описание

Командлет Set-AzSqlServerActiveDirectoryAdministrator подготавливает администратора Microsoft Entra для Сервера AzureSQL в текущей подписке. Одновременно можно подготовить только одного администратора. Следующие члены Microsoft Entra ID могут быть подготовлены в качестве администратора SQL Server:

  • Собственные члены Microsoft Entra ID
  • Федеративные члены Microsoft Entra ID
  • Импортированные члены из других Azure AD, которые являются собственными или федеративными членами
  • Microsoft Entra группы, созданные в качестве групп безопасности Майкрософт учетных записей, например в доменах Outlook.com, Hotmail.com или Live.com, не поддерживаются в качестве администраторов. Другие гостевые учетные записи, такие как Gmail.com или Yahoo.com доменах, не поддерживаются в качестве администраторов. Рекомендуется подготовить выделенную группу Microsoft Entra в качестве администратора.

Примеры

Пример 1. Подготовка группы администраторов для сервера

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

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

Эта команда подготавливает группу администраторов Microsoft Entra с именем DBAs для сервера с именем Server01. Этот сервер связан с группой ресурсов ResourceGroup01.

Пример 2. Подготовка пользователя администратора для сервера

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

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

Эта команда подготавливает пользователя Microsoft Entra в качестве администратора сервера с именем Server01.

Пример 3. Подготовка группы администраторов путем указания его идентификатора

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

Эта команда подготавливает группу администраторов Microsoft Entra с именем DBAs для сервера с именем Server01. Команда задает идентификатор параметра ObjectId . Это гарантирует, что команда выполнена успешно, даже если отображаемое имя группы не является уникальным.

Параметры

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметров

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

Свойства параметров

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisplayName

Указывает отображаемое имя администратора Microsoft Entra, который подготавливает этот командлет.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:2
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ObjectId

Указывает уникальный идентификатор администратора Microsoft Entra, который подготавливает этот командлет. Если отображаемое имя не является уникальным, необходимо указать значение для этого параметра.

Свойства параметров

Тип:Guid
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:3
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ResourceGroupName

Указывает имя группы ресурсов, которой назначается сервер.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ServerName

Указывает имя SQL Server, для которой этот командлет подготавливает администратора.

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметров

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

Guid

Выходные данные

AzureSqlServerActiveDirectoryAdministratorModel