New-AzSynapseRoleAssignment

Module:

Az.Synapse

Hiermee maakt u een Synapse Analytics-roltoewijzing.

Syntaxis

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

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

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

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

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

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

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

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

Description

De cmdlet New-AzSynapseRoleAssignment maakt een Azure Synapse Analytics-roltoewijzing.

De cmdlet kan onderstaande Microsoft Graph API aanroepen op basis van invoerparameters:

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

Notitie

Als u een roltoewijzing voor een service-principal wilt maken, geeft u de object-id van de principal door in de parameter ObjectId. Wanneer u een gebruiker bent met machtigingen voor het beheren van de Azure RBAC-roltoewijzing in de werkruimte, maar niet een Synapse-beheerder, maakt u de rol Synapse-administrator door -RoleDefinitionId en -ObjectId rechtstreeks, maar niet door -RoleDefinitionName, voor Synapse-beheerder, RoleDefinitionId is "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbbbb", neem hieronder voorbeeld 5 als referentie. De reden hiervoor is, wanneer u probeert een Synapse-beheerdersrol toe te voegen, moet de cmdlet de rol-id ophalen van de rolnaam waarvoor leesmachtiging voor de werkruimte is vereist, die de huidige gebruiker niet heeft.

Voorbeelden

Voorbeeld 1

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

Met deze opdracht wordt ContosoRole toegewezen aan de gebruiker waarvan de principalnaam ContosoName is.

Voorbeeld 2

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

Met deze opdracht wordt ContosoRole toegewezen aan de gebruiker waarvan de principal-naam ContosoName is en het itemtype ContosoItemType is, is het item ContosoItem.

Voorbeeld 3

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

Met deze opdracht wordt ContosoRole toegewezen aan de gebruiker waarvan de principal-naam ContosoName is en het itemtype ContosoItemType is, is het item ContosoItem.

Voorbeeld 4

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

Met deze opdracht wordt ContosoRole toegewezen aan de gebruiker waarvan de principal name ContosoName is via de pijplijn.

Voorbeeld 5

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

Met deze opdracht wordt de rol Synapse-beheerder toegewezen aan de gebruiker waarvan de object-id ContosoObjectId is via de pijplijn.

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliassen:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Item

Het werkruimte-item.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ItemType

Het type werkruimte-item.

Type:	Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
Geaccepteerde waarden:	ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ObjectId

De Microsoft Entra ObjectId van de gebruiker, groep of service-principal.

Type:	String
Aliassen:	Id, PrincipalId
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RoleDefinitionId

Id van de rol die is toegewezen aan de principal.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RoleDefinitionName

Naam van de rol die aan de principal is toegewezen.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ServicePrincipalName

De ServicePrincipalName van de service-principal.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SignInName

Het e-mailadres of de principal-naam van de gebruiker.

Type:	String
Aliassen:	Email, UserPrincipalName
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WorkspaceName

Naam van Synapse-werkruimte.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WorkspaceObject

werkruimte-invoerobject, meestal doorgegeven via de pijplijn.

Type:	PSSynapseWorkspace
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

Invoerwaarden

PSSynapseWorkspace

Uitvoerwaarden

PSRoleAssignmentDetails