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


Get-AzSynapseRoleAssignment

Возвращает назначение роли Synapse Analytics.

Синтаксис

Get-AzSynapseRoleAssignment
   -WorkspaceName <String>
   [-RoleDefinitionName <String>]
   [-SignInName <String>]
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzSynapseRoleAssignment
   -WorkspaceName <String>
   [-RoleDefinitionName <String>]
   [-ObjectId <String>]
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzSynapseRoleAssignment
   -WorkspaceName <String>
   -RoleDefinitionId <String>
   [-ObjectId <String>]
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzSynapseRoleAssignment
   -WorkspaceName <String>
   -RoleAssignmentId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzSynapseRoleAssignment
   -WorkspaceName <String>
   [-RoleDefinitionName <String>]
   [-ServicePrincipalName <String>]
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   [-RoleDefinitionName <String>]
   -SignInName <String>
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   [-RoleDefinitionName <String>]
   [-ObjectId <String>]
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   -RoleDefinitionId <String>
   [-ObjectId <String>]
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   -RoleAssignmentId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzSynapseRoleAssignment
   -WorkspaceObject <PSSynapseWorkspace>
   [-RoleDefinitionName <String>]
   -ServicePrincipalName <String>
   [-ItemType <WorkspaceItemType>]
   [-Item <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

Командлет Get-AzSynapseRoleAssignment получает назначение ролей Azure Synapse Analytics. Если не указать определение роли или имя участника-пользователя, этот командлет получает все назначения ролей.

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

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

Примечание.

Чтобы получить назначение роли для субъекта-службы, передайте идентификатор объекта субъекта в параметре ObjectId.

Примеры

Пример 1

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace

Эта команда получает все назначения ролей в рабочей области.

Пример 2

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole

Эта команда получает все назначения ролей в рабочей области ContosoWorkspace с именем роли ContosoRole.

Пример 3

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole -SignInName ContosoName

Эта команда получает назначение ролей в рабочей области ContosoWorkspace с именем роли ContosoRole и именем субъекта-пользователя ContosoName.

Пример 4

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole -SignInName ContosoName -ItemType ContosoItemType

Эта команда получает назначения ролей в рабочей области ContosoWorkspace с именем роли ContosoRole, именем субъекта-пользователя ContosoName и под типом ContosoItemtype.

Пример 5

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole -SignInName ContosoName -ItemType ContosoItemType -Item ContosoItem

Эта команда получает назначение ролей в рабочей области ContosoWorkspace с именем роли ContosoRole, именем субъекта-пользователя ContosoName, ContosoItemType и ContosoItem.

Пример 6

$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | Get-AzSynapseRoleAssignment

Эта команда получает все назначения ролей в рабочей области через конвейер.

Параметры

-DefaultProfile

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

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Item

Элемент рабочей области Azure Synapse.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-ItemType

Тип элемента рабочей области Azure Synapse.

Тип:Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
допустимые значения:ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Объект Microsoft Entra ObjectId пользователя, группы или субъекта-службы.

Тип:String
Aliases:Id, PrincipalId
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleAssignmentId

Идентификатор назначения роли.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:False
Accept wildcard characters:False

-RoleDefinitionId

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

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:False
Accept wildcard characters:False

-RoleDefinitionName

Имя роли, назначенной субъекту.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalName

ServicePrincipalName субъекта-службы.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:False
Accept wildcard characters:False

-SignInName

Адрес электронной почты или имя участника-пользователя пользователя.

Тип:String
Aliases:Email, UserPrincipalName
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:False
Accept wildcard characters:False

-WorkspaceName

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

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:False
Accept wildcard characters:False

-WorkspaceObject

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

Тип:PSSynapseWorkspace
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

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

PSSynapseWorkspace

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

PSRoleAssignmentDetails