Compartir a través de

Get-AzSynapseRoleAssignment

Módulo:
Az.Synapse Module

Obtiene una asignación de roles de Synapse Analytics.

Sintaxis

GetByWorkspaceNameAndNameParameterSet (valor predeterminado) 

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>]

Description

El cmdlet Get-AzSynapseRoleAssignment obtiene una asignación de roles de Azure Synapse Analytics. Si no especifica una definición de rol o un nombre principal de usuario, este cmdlet obtiene toda la asignación de roles.

El cmdlet puede llamar a microsoft Graph API debajo según los parámetros de entrada:

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

Nota:

Para recuperar una asignación de roles para una entidad de servicio, pase el identificador de objeto de la entidad de seguridad en el parámetro ObjectId.

Ejemplos

Ejemplo 1

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace

Este comando obtiene todas las asignaciones de roles en un área de trabajo.

Ejemplo 2

Get-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleDefinitionName ContosoRole

Este comando obtiene todas las asignaciones de roles en el área de trabajo ContosoWorkspace con el nombre de rol ContosoRole.

Ejemplo 3

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

Este comando obtiene una asignación de roles en el área de trabajo ContosoWorkspace con el nombre de rol ContosoRole y el nombre principal de usuario ContosoName.

Ejemplo 4

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

Este comando obtiene asignaciones de roles en el área de trabajo ContosoWorkspace con el nombre de rol ContosoRole, el nombre principal de usuario ContosoName y en itemtype ContosoItemtype.

Ejemplo 5

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

Este comando obtiene una asignación de roles en el área de trabajo ContosoWorkspace con el nombre de rol ContosoRole, el nombre principal de usuario ContosoName, ContosoItemType y ContosoItem.

Ejemplo 6

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

Este comando obtiene todas las asignaciones de roles de un área de trabajo a través de la canalización.

Parámetros

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Item

Elemento del área de trabajo de Azure Synapse.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetByWorkspaceNameAndNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceNameAndIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ItemType

El tipo de elemento del área de trabajo de Azure Synapse.

Propiedades de parámetro

Tipo:Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
Valor predeterminado:None
Valores aceptados:ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetByWorkspaceNameAndNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceNameAndIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ObjectId

Microsoft Entra ObjectId del usuario, grupo o entidad de servicio.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Id, PrincipalId

Conjuntos de parámetros

GetByWorkspaceNameAndIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RoleAssignmentId

Identificador de la asignación de roles.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetByWorkspaceNameAndAssignmentIdParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndAssignmentIdParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RoleDefinitionId

Identificador del rol asignado a la entidad de seguridad.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RoleDefinitionName

Nombre del rol asignado a la entidad de seguridad.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetByWorkspaceNameAndNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceNameAndIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndIdParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServicePrincipalName

ServicePrincipalName de la entidad de servicio.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetByWorkspaceNameAndServicePrincipalNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SignInName

La dirección de correo electrónico o el nombre principal de usuario del usuario.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Correo Electrónico, NombrePrincipalDelUsuario

Conjuntos de parámetros

GetByWorkspaceNameAndNameParameterSet
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WorkspaceName

Nombre del área de trabajo de Synapse.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetByWorkspaceNameAndNameParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceNameAndIdParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceNameAndAssignmentIdParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceNameAndServicePrincipalNameParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WorkspaceObject

objeto de entrada del área de trabajo, que normalmente se pasa a través de la canalización.

Propiedades de parámetro

Tipo:PSSynapseWorkspace
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetByWorkspaceObjectAndNameParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndIdParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndAssignmentIdParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
GetByWorkspaceObjectAndServicePrincipalNameParameterSet
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSSynapseWorkspace

Salidas

PSRoleAssignmentDetails