Get-AzSynapseRoleAssignment

Referencia

Módulo:: Az.Synapse

Obtiene una asignación de roles de Synapse Analytics.

Sintaxis

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

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

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Item

Elemento del área de trabajo de Azure Synapse.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ItemType

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

Tipo:	Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
Valores aceptados:	ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ObjectId

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

Tipo:	String
Alias:	Id, PrincipalId
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RoleAssignmentId

Identificador de la asignación de roles.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RoleDefinitionId

Identificador del rol asignado a la entidad de seguridad.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RoleDefinitionName

Nombre del rol asignado a la entidad de seguridad.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ServicePrincipalName

ServicePrincipalName de la entidad de servicio.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SignInName

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

Tipo:	String
Alias:	Email, UserPrincipalName
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WorkspaceName

Nombre del área de trabajo de Synapse.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WorkspaceObject

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

Tipo:	PSSynapseWorkspace
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

Entradas

PSSynapseWorkspace

Salidas

PSRoleAssignmentDetails

Compartir a través de