Partilhar via


Remove-AzSynapseRoleAssignment

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

Sintaxe

RemoveByWorkspaceNameAndNameParameterSet (Padrão)

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

RemoveByWorkspaceNameAndIdParameterSet

Remove-AzSynapseRoleAssignment
    -WorkspaceName <String>
    -RoleAssignmentId <String>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RemoveByWorkspaceNameAndObjectIdParameterSet

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

RemoveByWorkspaceNameAndRoleDefinitionIdParameterSet

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

RemoveByWorkspaceNameAndServicePrincipalNameParameterSet

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

RemoveByWorkspaceObjectAndIdParameterSet

Remove-AzSynapseRoleAssignment
    -WorkspaceObject <PSSynapseWorkspace>
    -RoleAssignmentId <String>
    [-PassThru]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RemoveByWorkspaceObjectAndNameParameterSet

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

RemoveByWorkspaceObjectAndObjectIdParameterSet

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

RemoveByWorkspaceObjectAndRoleDefinitionIdParameterSet

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

RemoveByWorkspaceObjectAndServicePrincipalNameParameterSet

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

Descrição

O cmdlet Remove-AzSynapseRoleAssignment exclui permanentemente 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 remover 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

Remove-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleAssignmentId ContosoRoleAssignmentId

Este comando exclui uma atribuição de função do Azure Synapse Analytics com uma ID de atribuição de função.

Exemplo 2

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

Este comando exclui uma atribuição de função do Azure Synapse Analytics no nível do espaço de trabalho com um nome de função e um nome de entidade de usuário.

Exemplo 3

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

Este comando exclui uma atribuição de função do Azure Synapse Analytics com um nome de função, um nome principal de usuário, um tipo de item e um item.

Exemplo 4

$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | Remove-AzSynapseRoleAssignment -RoleAssignmentId ContosoRoleAssignmentId

Este comando exclui uma atribuição de função do Azure Synapse Analytics com uma ID de atribuição de função 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 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

RemoveByWorkspaceNameAndNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceNameAndObjectIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceNameAndRoleDefinitionIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceNameAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceObjectAndNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceObjectAndObjectIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceObjectAndRoleDefinitionIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceObjectAndServicePrincipalNameParameterSet
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

RemoveByWorkspaceNameAndNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceNameAndObjectIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceNameAndRoleDefinitionIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceNameAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceObjectAndNameParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceObjectAndObjectIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceObjectAndRoleDefinitionIdParameterSet
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceObjectAndServicePrincipalNameParameterSet
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

RemoveByWorkspaceNameAndObjectIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceNameAndRoleDefinitionIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceObjectAndObjectIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceObjectAndRoleDefinitionIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-PassThru

Este cmdlet não retorna um objeto por padrão. Se essa opção for especificada, ela retornará true se for bem-sucedida.

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

-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

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

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

RemoveByWorkspaceNameAndNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceNameAndObjectIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceNameAndServicePrincipalNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceObjectAndNameParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceObjectAndObjectIdParameterSet
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False
RemoveByWorkspaceObjectAndServicePrincipalNameParameterSet
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

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

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

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

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

Boolean