Partilhar via

New-AzSynapseRoleAssignment

Módulo:
Az.Synapse Module

Cria uma atribuição de função do Synapse Analytics.

Sintaxe

NewByWorkspaceNameAndNameParameterSet (Padrão) 

New-AzSynapseRoleAssignment
    -WorkspaceName <String>
    -RoleDefinitionName <String>
    -SignInName <String>
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NewByWorkspaceNameAndIdParameterSet 

New-AzSynapseRoleAssignment
    -WorkspaceName <String>
    -RoleDefinitionName <String>
    -ObjectId <String>
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NewByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet 

New-AzSynapseRoleAssignment
    -WorkspaceName <String>
    -RoleDefinitionId <String>
    -ObjectId <String>
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NewByWorkspaceNameAndServicePrincipalNameParameterSet 

New-AzSynapseRoleAssignment
    -WorkspaceName <String>
    -RoleDefinitionName <String>
    -ServicePrincipalName <String>
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NewByWorkspaceObjectAndNameParameterSet 

New-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    -RoleDefinitionName <String>
    -SignInName <String>
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NewByWorkspaceObjectAndIdParameterSet 

New-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    -RoleDefinitionName <String>
    -ObjectId <String>
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NewByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet 

New-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    -RoleDefinitionId <String>
    -ObjectId <String>
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NewByWorkspaceObjectAndServicePrincipalNameParameterSet 

New-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    -RoleDefinitionName <String>
    -ServicePrincipalName <String>
    [-ItemType <WorkspaceItemType>]
    [-Item <String>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrição

O cmdlet New-AzSynapseRoleAssignment cria uma atribuição de função do Azure Synapse Analytics.

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 criar uma atribuição de função para uma entidade de serviço, passe a ID do objeto da entidade no parâmetro ObjectId. Quando você for um usuário com permissão para gerenciar a atribuição de função RBAC do Azure no espaço de trabalho, mas não um Administrador Synapse, crie a função de Administrador Synapse por -RoleDefinitionId e -ObjectId diretamente, mas não por -RoleDefinitionName, para Synapse Administrator, RoleDefinitionId é "00001111-aaaa-2222-bbbb-3333cccc444", tome abaixo o Exemplo 5 como referência. O motivo para isso é que, quando você tenta adicionar uma função "Synapse Administrator", o cmdlet precisa obter a ID da função do nome da função que requer permissão de leitura do espaço de trabalho, que o usuário atual não tem.

Exemplos

Exemplo 1

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

Este comando atribui ContosoRole ao usuário cujo nome principal é ContosoName.

Exemplo 2

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

Este comando atribui ContosoRole ao usuário cujo nome principal é ContosoName e o tipo de item é ContosoItemType, item é ContosoItem.

Exemplo 3

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

Este comando atribui ContosoRole ao usuário cujo nome principal é ContosoName e o tipo de item é ContosoItemType, item é ContosoItem.

Exemplo 4

$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | New-AzSynapseRoleAssignment -RoleDefinitionName ContosoRole -SignInName ContosoName

Este comando atribui ContosoRole ao usuário cujo nome principal é ContosoName através do pipeline.

Exemplo 5

$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | New-AzSynapseRoleAssignment -RoleDefinitionId "00001111-aaaa-2222-bbbb-3333cccc4444" -ObjectId ContosoObjectId

Este comando atribui a função Synapse Administrator ao usuário cujo objeto Id é ContosoObjectId através do pipeline.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Propriedades dos parâmetros

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

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

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:Cf.

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

-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 de espaço de trabalho.

Propriedades dos parâmetros

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

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

-ItemType

O tipo de item de espaço de trabalho.

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

(All)
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

NewByWorkspaceNameAndIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceObjectAndIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
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

NewByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
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

NewByWorkspaceNameAndNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceNameAndIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceNameAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceObjectAndNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceObjectAndIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceObjectAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:True
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

NewByWorkspaceNameAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceObjectAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:True
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

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:Wi

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

-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

NewByWorkspaceNameAndNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceNameAndIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceNameAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceNameAndServicePrincipalNameParameterSet
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

NewByWorkspaceObjectAndNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceObjectAndIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceObjectAndRoleDefinitionIdAndObjectIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
NewByWorkspaceObjectAndServicePrincipalNameParameterSet
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