Partilhar via

Get-AzSynapseRoleAssignment

Módulo:
Az.Synapse Module

Obtém uma atribuição de função do Synapse Analytics.

Sintaxe

GetByWorkspaceNameAndNameParameterSet (Padrão) 

Get-AzSynapseRoleAssignment
    -WorkspaceName <String>
    [-RoleDefinitionName <String>]
    [-SignInName <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceNameAndIdParameterSet 

Get-AzSynapseRoleAssignment
    -WorkspaceName <String>
    [-RoleDefinitionName <String>]
    [-ObjectId <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet 

Get-AzSynapseRoleAssignment
    -WorkspaceName <String>
    -RoleDefinitionId <String>
    [-ObjectId <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceNameAndAssignmentIdParameterSet 

Get-AzSynapseRoleAssignment
    -WorkspaceName <String>
    -RoleAssignmentId <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceNameAndServicePrincipalNameParameterSet 

Get-AzSynapseRoleAssignment
    -WorkspaceName <String>
    [-RoleDefinitionName <String>]
    [-ServicePrincipalName <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceObjectAndNameParameterSet 

Get-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    -SignInName <String>
    [-RoleDefinitionName <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceObjectAndIdParameterSet 

Get-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    [-RoleDefinitionName <String>]
    [-ObjectId <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet 

Get-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    -RoleDefinitionId <String>
    [-ObjectId <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceObjectAndAssignmentIdParameterSet 

Get-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    -RoleAssignmentId <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetByWorkspaceObjectAndServicePrincipalNameParameterSet 

Get-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    -ServicePrincipalName <String>
    [-RoleDefinitionName <String>]
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Descrição

O cmdlet Get-AzSynapseRoleAssignment obtém uma Atribuição de Função do Azure Synapse Analytics. Se você não especificar uma definição de função ou um nome de entidade de usuário, esse cmdlet obterá toda a atribuição de função.

O cmdlet pode chamar abaixo a API do Microsoft Graph de acordo com os parâmetros de entrada:

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

Observação

Para recuperar uma atribuição de função para uma entidade de serviço, passe a ID do objeto da entidade no parâmetro ObjectId.

Exemplos

Exemplo 1

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace

Este comando obtém todas as atribuições de função em um espaço de trabalho.

Exemplo 2

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole

Este comando obtém todas as atribuições de função no espaço de trabalho ContosoWorkspace com o nome da função ContosoRole.

Exemplo 3

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

Este comando obtém uma atribuição de função no espaço de trabalho ContosoWorkspace com o nome da função ContosoRole e o nome principal do usuário ContosoName.

Exemplo 4

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

Este comando obtém atribuições de função no espaço de trabalho ContosoWorkspace com o nome da função ContosoRole, o nome principal do usuário ContosoName e em itemtype ContosoItemtype.

Exemplo 5

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

Este comando obtém uma atribuição de função no espaço de trabalho ContosoWorkspace com o nome da função ContosoRole, o nome principal do usuário ContosoName, ContosoItemType e ContosoItem.

Exemplo 6

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

Este comando obtém todas as atribuições de função em um espaço de trabalho através do pipeline.

Parâmetros

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Item

O item do espaço de trabalho do Azure Synapse.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

GetByWorkspaceNameAndNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceNameAndIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ItemType

O itemtype do espaço de trabalho do Azure Synapse.

Propriedades dos parâmetros

Tipo:Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
Valor padrão:None
Valores aceites:ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

GetByWorkspaceNameAndNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceNameAndIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ObjectId

O Microsoft Entra ObjectId do usuário, grupo ou entidade de serviço.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:Id, PrincipalId

Conjuntos de parâmetros

GetByWorkspaceNameAndIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-RoleAssignmentId

A ID da atribuição de função.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

GetByWorkspaceNameAndAssignmentIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndAssignmentIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-RoleDefinitionId

Id da Função atribuída à entidade de segurança.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-RoleDefinitionName

Nome da Função atribuída à entidade de segurança.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

GetByWorkspaceNameAndNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceNameAndIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ServicePrincipalName

O ServicePrincipalName da entidade de serviço.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

GetByWorkspaceNameAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-SignInName

O endereço de e-mail ou o nome principal do usuário.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:Email, Nome Principal do Utilizador

Conjuntos de parâmetros

GetByWorkspaceNameAndNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-WorkspaceName

Nome do espaço de trabalho Sinapse.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

GetByWorkspaceNameAndNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceNameAndIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceNameAndAssignmentIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-WorkspaceObject

objeto de entrada do espaço de trabalho, geralmente passado pelo pipeline.

Propriedades dos parâmetros

Tipo:PSSynapseWorkspace
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

GetByWorkspaceObjectAndNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndAssignmentIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSSynapseWorkspace

Saídas

PSRoleAssignmentDetails