Delen via

az synapse role assignment

De roltoewijzingen van Synapse beheren.

Opdracht

Name Description Type Status
az synapse role assignment create

Maak een roltoewijzing.

 Core GA
az synapse role assignment delete

Roltoewijzingen van werkruimte verwijderen.

 Core GA
az synapse role assignment list

Roltoewijzingen weergeven.

 Core GA
az synapse role assignment show

Haal een roltoewijzing op id op.

 Core GA

az synapse role assignment create

Bewerken

Maak een roltoewijzing.

az synapse role assignment create --role
                                  --workspace-name
                                  [--assignee]
                                  [--assignee-object-id]
                                  [--assignee-principal-type --assignee-type {Group, ServicePrincipal, User}]
                                  [--assignment-id]
                                  [--item]
                                  [--item-type {bigDataPools, credentials, integrationRuntimes, linkedServices}]
                                  [--scope]

Voorbeelden

Maak een roltoewijzing met behulp van de naam van de service-principal.

az synapse role assignment create --workspace-name testsynapseworkspace \
--role "Synapse Administrator" --assignee sp_name

Maak een roltoewijzing met de principal-naam van de gebruiker.

az synapse role assignment create --workspace-name testsynapseworkspace \
--role "Synapse Administrator" --assignee username@contoso.com

Maak een roltoewijzing met behulp van objectId van de gebruiker, groep of service-principal.

az synapse role assignment create --workspace-name testsynapseworkspace \
--role "Synapse Administrator" --assignee 00000000-0000-0000-0000-000000000000

Maak een roltoewijzing binnen het bereik.

az synapse role assignment create --workspace-name testsynapseworkspace \
--scope "workspaces/{workspaceName}" --role "Synapse Administrator" --assignee username@contoso.com

Maak een roltoewijzing binnen het bereik die combinatie van itemtype en itemnaam.

az synapse role assignment create --workspace-name testsynapseworkspace \
--item-type "bigDataPools" --item "bigDataPoolName" --role "Synapse Administrator" \
--assignee username@contoso.com

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 een roltoewijzing door -role roleid. 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.

az synapse role assignment create \
--workspace-name testsynapseworkspace \
--role "6e4bf58a-b8e1-4cc3-bbf9-d73143322b78" \
--assignee username@contoso.com

Vereiste parameters

--role

De rolnaam/id die aan de principal is toegewezen.

--workspace-name

De naam van de werkruimte.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--assignee

Vertegenwoordig een gebruiker of service-principal. Ondersteunde indeling: object-id, aanmeldingsnaam van gebruiker of service-principalnaam.

--assignee-object-id

Gebruik deze parameter in plaats van '--assignee' om Graph API-aanroep te omzeilen in geval van onvoldoende bevoegdheden. Deze parameter werkt alleen met object-id's voor gebruikers, groepen, service-principals en beheerde identiteiten. Gebruik voor beheerde identiteiten de principal-id. Gebruik voor service-principals de object-id en niet de app-id.

--assignee-principal-type --assignee-type

Gebruik met --assignee-object-id om fouten te voorkomen die worden veroorzaakt door de doorgiftelatentie in AAD Graph.

Eigenschap Waarde
Geaccepteerde waarden: Group, ServicePrincipal, User
--assignment-id

Aangepaste roltoewijzings-id in guid-indeling, indien niet opgegeven, toewijzings-id wordt willekeurig gegenereerd.

--item

Item dat toegang heeft verleend in de werkruimte. Gebruiken met --item-type om het bereik van de toewijzing te combineren.

--item-type

Itemtype heeft toegang verleend in de werkruimte. Gebruiken met --item om het toewijzingsbereik te combineren.

Eigenschap Waarde
Geaccepteerde waarden: bigDataPools, credentials, integrationRuntimes, linkedServices
--scope

Een bereik definieert de resources of artefacten waarop de toegang van toepassing is. Synapse ondersteunt hiërarchische bereiken. Machtigingen die zijn verleend in een bereik op een hoger niveau, worden overgenomen door objecten op een lager niveau. In Synapse RBAC is het bereik op het hoogste niveau een werkruimte. Het toewijzen van een rol met werkruimtebereik verleent machtigingen aan alle toepasselijke objecten in de werkruimte.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az synapse role assignment delete

Bewerken

Roltoewijzingen van werkruimte verwijderen.

az synapse role assignment delete --workspace-name
                                  [--assignee]
                                  [--assignee-object-id]
                                  [--ids]
                                  [--item]
                                  [--item-type {bigDataPools, credentials, integrationRuntimes, linkedServices}]
                                  [--role]
                                  [--scope]
                                  [--yes]

Voorbeelden

Roltoewijzingen per rol en toegewezen gebruiker verwijderen.

az synapse role assignment delete --workspace-name testsynapseworkspace \
--role "Synapse Administrator" --assignee sp_name

Roltoewijzingen verwijderen op rol-id/naam.

az synapse role assignment delete --workspace-name testsynapseworkspace \
--role "Synapse Administrator"

Verwijder roltoewijzingen op service-principalnaam.

az synapse role assignment delete --workspace-name testsynapseworkspace \
--assignee sp_name

Roltoewijzingen verwijderen op user principal name.

az synapse role assignment delete --workspace-name testsynapseworkspace \
--assignee username@contoso.com

Roltoewijzingen verwijderen op objectId van de gebruiker, groep of service-principal.

az synapse role assignment delete --workspace-name testsynapseworkspace \
--assignee 00000000-0000-0000-0000-000000000001

Roltoewijzingen op id's verwijderen.

az synapse role assignment delete --workspace-name testsynapseworkspace \
--ids 10000000-0000-0000-0000-10000000-10000000-0000-0000-0000-10000000

Roltoewijzingen per bereik verwijderen.

az synapse role assignment delete --workspace-name testsynapseworkspace \
--scope "workspaces/testsynapseworkspace/linkedServices/testlinkedServices"

Vereiste parameters

--workspace-name

De naam van de werkruimte.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--assignee

Vertegenwoordig een gebruiker of service-principal. Ondersteunde indeling: object-id, aanmeldingsnaam van gebruiker of service-principalnaam.

--assignee-object-id

Gebruik deze parameter in plaats van '--assignee' om Graph API-aanroep te omzeilen in geval van onvoldoende bevoegdheden. Deze parameter werkt alleen met object-id's voor gebruikers, groepen, service-principals en beheerde identiteiten. Gebruik voor beheerde identiteiten de principal-id. Gebruik voor service-principals de object-id en niet de app-id.

--ids

Id's voor door ruimte gescheiden roltoewijzingen. U moet --role of --assignee niet opgeven wanneer --id's worden opgegeven.

--item

Item dat toegang heeft verleend in de werkruimte. Gebruiken met --item-type om het bereik van de toewijzing te combineren. Gebruik az role assignment with filter condition voordat u de verwijderbewerking uitvoert om duidelijk te weten welke toewijzingen worden verwijderd.

--item-type

Itemtype heeft toegang verleend in de werkruimte. Gebruiken met --item om het toewijzingsbereik te combineren. Gebruik az role assignment with filter condition voordat u de verwijderbewerking uitvoert om duidelijk te weten welke toewijzingen worden verwijderd.

Eigenschap Waarde
Geaccepteerde waarden: bigDataPools, credentials, integrationRuntimes, linkedServices
--role

De rolnaam/id die aan de principal is toegewezen.

--scope

Een bereik definieert de resources of artefacten waarop de toegang van toepassing is. Synapse ondersteunt hiërarchische bereiken. Machtigingen die zijn verleend in een bereik op een hoger niveau, worden overgenomen door objecten op een lager niveau. In Synapse RBAC is het bereik op het hoogste niveau een werkruimte. Gebruik az role assignment with filter condition voordat u de verwijderbewerking uitvoert om duidelijk te weten welke toewijzingen worden verwijderd.

--yes -y

Niet vragen om bevestiging.

Eigenschap Waarde
Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az synapse role assignment list

Bewerken

Roltoewijzingen weergeven.

az synapse role assignment list --workspace-name
                                [--assignee]
                                [--assignee-object-id]
                                [--item]
                                [--item-type {bigDataPools, credentials, integrationRuntimes, linkedServices}]
                                [--role]
                                [--scope]

Voorbeelden

Roltoewijzingen weergeven.

az synapse role assignment list --workspace-name testsynapseworkspace

Roltoewijzingen weergeven op rol-id/naam.

az synapse role assignment list --workspace-name testsynapseworkspace \
--role "Synapse Apache Spark Administrator"

Roltoewijzingen per toegewezen gebruiker weergeven.

az synapse role assignment list --workspace-name testsynapseworkspace \
--assignee sp_name

Roltoewijzingen weergeven op objectId van de gebruiker, groep of service-principal.

az synapse role assignment list --workspace-name testsynapseworkspace \
--assignee-object-id 00000000-0000-0000-0000-000000000000

Roltoewijzingen per bereik weergeven.

az synapse role assignment list --workspace-name testsynapseworkspace \
--scope "workspaces/{workspaceName}"

Roltoewijzingen weergeven op itemtype en itemnaam.

az synapse role assignment list --workspace-name testsynapseworkspace \
--item-type "bigDataPools" --item "bigDataPoolName"

Vereiste parameters

--workspace-name

De naam van de werkruimte.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--assignee

Vertegenwoordig een gebruiker of service-principal. Ondersteunde indeling: object-id, aanmeldingsnaam van gebruiker of service-principalnaam.

--assignee-object-id

Gebruik deze parameter in plaats van '--assignee' om Graph API-aanroep te omzeilen in geval van onvoldoende bevoegdheden. Deze parameter werkt alleen met object-id's voor gebruikers, groepen, service-principals en beheerde identiteiten. Gebruik voor beheerde identiteiten de principal-id. Gebruik voor service-principals de object-id en niet de app-id.

--item

Item dat toegang heeft verleend in de werkruimte. Gebruiken met --item-type om het bereik van de toewijzing te combineren.

--item-type

Itemtype heeft toegang verleend in de werkruimte. Gebruiken met --item om het toewijzingsbereik te combineren.

Eigenschap Waarde
Geaccepteerde waarden: bigDataPools, credentials, integrationRuntimes, linkedServices
--role

De rolnaam/id die aan de principal is toegewezen.

--scope

Een bereik definieert de resources of artefacten waarop de toegang van toepassing is. Synapse ondersteunt hiërarchische bereiken. Machtigingen die zijn verleend in een bereik op een hoger niveau, worden overgenomen door objecten op een lager niveau. In Synapse RBAC is het bereik op het hoogste niveau een werkruimte. Het toewijzen van een rol met werkruimtebereik verleent machtigingen aan alle toepasselijke objecten in de werkruimte.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az synapse role assignment show

Bewerken

Haal een roltoewijzing op id op.

az synapse role assignment show --id
                                --workspace-name

Voorbeelden

Haal een roltoewijzing op id op.

az synapse role assignment show --workspace-name testsynapseworkspace \
--id 00000000-0000-0000-0000-000000000000

Vereiste parameters

--id

Id van de rol die is toegewezen aan de principal.

--workspace-name

De naam van de werkruimte.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False