Remove-AzSynapseRoleAssignment

參考

模組:: Az.Synapse

刪除 Synapse Analytics 角色指派。

語法

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

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

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

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

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

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

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

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

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

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

Description

Remove-AzSynapseRoleAssignment Cmdlet 會永久刪除 Azure Synapse Analytics 角色指派。

Cmdlet 可能會根據輸入參數呼叫下列Microsoft圖形 API：

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

注意

若要移除服務主體的角色指派，請在 ObjectId 參數中傳遞主體的物件識別碼。

範例

範例 1

Remove-AzSynapseRoleAssignment -WorkspaceName ContosoWorkspace -RoleAssignmentId ContosoRoleAssignmentId

此命令會刪除具有角色指派標識符的 Azure Synapse Analytics 角色指派。

範例 2

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

此命令會刪除工作區層級具有角色名稱和用戶主體名稱的 Azure Synapse Analytics 角色指派。

範例 3

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

此命令會刪除具有角色名稱、用戶主體名稱、專案類型和專案之 Azure Synapse Analytics 角色指派。

範例 4

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

此命令會透過管線刪除具有角色指派標識符的 Azure Synapse Analytics 角色指派。

參數

-AsJob

在背景執行 Cmdlet

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Item

Azure Synapse 工作區的專案。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ItemType

Azure Synapse 工作區的 itemtype。

類型:	Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
接受的值:	ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ObjectId

使用者、群組或服務主體的 Microsoft Entra ObjectId。

類型:	String
別名:	Id, PrincipalId
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PassThru

此 Cmdlet 預設不會傳回物件。如果指定此參數，如果成功，則會傳回 true。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RoleAssignmentId

角色指派的標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-RoleDefinitionId

指派給主體的角色標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-RoleDefinitionName

指派給主體的角色名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ServicePrincipalName

服務主體的 ServicePrincipalName。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SignInName

用戶的電子郵件地址或用戶主體名稱。

類型:	String
別名:	Email, UserPrincipalName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WorkspaceName

Synapse 工作區的名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-WorkspaceObject

工作區輸入物件，通常是透過管線傳遞。

類型:	PSSynapseWorkspace
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

輸入

PSSynapseWorkspace

輸出

Boolean

共用方式為