Set-AzSynapseSqlActiveDirectoryAdministrator

Модуль:

Az.Synapse Module

Подготавливает администратора Microsoft Entra для пула SQL Synapse Analytics.

Синтаксис

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

Set-AzSynapseSqlActiveDirectoryAdministrator
    -WorkspaceName <String>
    -DisplayName <String>
    [-ResourceGroupName <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByNameAndObjectIdParameterSet

Set-AzSynapseSqlActiveDirectoryAdministrator
    -WorkspaceName <String>
    -ObjectId <Guid>
    [-ResourceGroupName <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByInputObjectAndDisplayNameParameterSet

Set-AzSynapseSqlActiveDirectoryAdministrator
    -InputObject <PSSynapseWorkspace>
    -DisplayName <String>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByInputObjectAndObjectIdParameterSet

Set-AzSynapseSqlActiveDirectoryAdministrator
    -InputObject <PSSynapseWorkspace>
    -ObjectId <Guid>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourceIdAndDisplayNameParameterSet

Set-AzSynapseSqlActiveDirectoryAdministrator
    -ResourceId <String>
    -DisplayName <String>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourceIdAndObjectIdParameterSet

Set-AzSynapseSqlActiveDirectoryAdministrator
    -ResourceId <String>
    -ObjectId <Guid>
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

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

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

Командлет может вызвать ниже Microsoft API Graph в соответствии с входным параметрами:

• GET /users/{id}
• GET /servicePrincipals/{id}
• GET /groups/{id}

Примеры

Пример 1

Set-AzSynapseSqlActiveDirectoryAdministrator -WorkspaceName ContosoWorkspace -DisplayName "DBAs"

Эта команда подготавливает группу администраторов Microsoft Entra с именем DBAs для рабочей области ContosoWorkspace.

Пример 2

Set-AzSynapseSqlActiveDirectoryAdministrator -WorkspaceName ContosoWorkspace -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"

Эта команда подготавливает администратора Microsoft Entra по объекту ObjectId для рабочей области с именем ContosoWorkspace.

Параметры

-AsJob

Запуск командлета в фоновом режиме

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

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

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

(All)

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

-Confirm

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

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

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	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

Указывает отображаемое имя пользователя или группы, для которого необходимо предоставить разрешения. Это отображаемое имя должно существовать в Active Directory, связанном с текущей подпиской.

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

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

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

SetByNameAndDisplayNameParameterSet

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

SetByInputObjectAndDisplayNameParameterSet

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

SetByResourceIdAndDisplayNameParameterSet

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

-InputObject

Входной объект рабочей области, обычно передаваемый через конвейер.

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

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

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

SetByInputObjectAndDisplayNameParameterSet

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

SetByInputObjectAndObjectIdParameterSet

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

-ObjectId

Указывает идентификатор объекта пользователя или группы в Microsoft Entra ID для предоставления разрешений.

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

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

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

SetByNameAndObjectIdParameterSet

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

SetByInputObjectAndObjectIdParameterSet

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

SetByResourceIdAndObjectIdParameterSet

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

-ResourceGroupName

Имя группы ресурсов.

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

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

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

SetByNameAndDisplayNameParameterSet

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

SetByNameAndObjectIdParameterSet

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

-ResourceId

Идентификатор ресурса рабочей области Synapse.

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

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

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

SetByResourceIdAndDisplayNameParameterSet

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

SetByResourceIdAndObjectIdParameterSet

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

-WhatIf

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

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

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

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

(All)

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

-WorkspaceName

Имя рабочей области Synapse.

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

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

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

SetByNameAndDisplayNameParameterSet

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

SetByNameAndObjectIdParameterSet

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

CommonParameters

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

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

PSSynapseWorkspace

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

PSWorkspaceAadAdminInfo