Megosztás a következőn keresztül:

New-AzSynapseRoleAssignment

  • Referencia
Modul:
Az.Synapse

Létrehoz egy Synapse Analytics-szerepkör-hozzárendelést.

Syntax

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

A New-AzSynapseRoleAssignment parancsmag létrehoz egy Azure Synapse Analytics-szerepkör-hozzárendelést.

A parancsmag a bemeneti paramétereknek megfelelően meghívhatja a Microsoft Graph API-t:

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

Feljegyzés

A szolgáltatásnévhez tartozó szerepkör-hozzárendelés létrehozásához adja meg a rendszernév objektumazonosítóját az ObjectId paraméterben. Ha Ön olyan felhasználó, aki jogosult az Azure RBAC-szerepkör-hozzárendelés kezelésére a munkaterületen, de synapse-rendszergazda nem, hozzon létre Synapse-rendszergazdai szerepkört közvetlenül a -RoleDefinitionId és -ObjectId alapján, de a -RoleDefinitionName szerint, a Synapse-rendszergazda esetében a RoleDefinitionId a következő: "6e4bf58a-b8e1-4cc3-bbf9-d731433222b78", kérjük, tekintse meg az 5. példát hivatkozásként. Ennek az az oka, hogy amikor "Synapse-rendszergazda" szerepkört próbál hozzáadni, a parancsmagnak le kell kérnie a szerepkör azonosítóját a szerepkör nevéből, amelyhez munkaterület-olvasási engedély szükséges, amelyhez az aktuális felhasználó nem rendelkezik.

Példák

1. példa

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

Ez a parancs contosoRole-t rendel ahhoz a felhasználóhoz, akinek az egyszerű neve ContosoName.

2. példa

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

Ez a parancs contosoRole-t rendel ahhoz a felhasználóhoz, akinek az egyszerű neve ContosoName, az elem típusa ContosoItemType, az elem pedig ContosoItem.

3. példa

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

Ez a parancs contosoRole-t rendel ahhoz a felhasználóhoz, akinek az egyszerű neve ContosoName, az elem típusa ContosoItemType, az elem pedig ContosoItem.

4. példa

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

Ez a parancs contosoRole-t rendel ahhoz a felhasználóhoz, akinek az egyszerű neve ContosoName a folyamaton keresztül.

5. példa

$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | New-AzSynapseRoleAssignment -RoleDefinitionId "6e4bf58a-b8e1-4cc3-bbf9-d73143322b78" -ObjectId ContosoObjectId

Ez a parancs synapse-rendszergazdai szerepkört rendel ahhoz a felhasználóhoz, akinek az objektumazonosítója ContosoObjectId a folyamaton keresztül.

Paraméterek

-AsJob

Parancsmag futtatása a háttérben

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Típus:IAzureContextContainer
Aliasok:AzContext, AzureRmContext, AzureCredential
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Item

A munkaterület eleme.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ItemType

A munkaterület elemtípusa.

Típus:Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
Elfogadott értékek:ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ObjectId

A felhasználó, csoport vagy szolgáltatásnév Microsoft Entra ObjectId azonosítója.

Típus:String
Aliasok:Id, PrincipalId
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-RoleDefinitionId

Az egyszerű szerepkörhöz rendelt szerepkör azonosítója.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-RoleDefinitionName

Az egyszerű szerepkörhöz rendelt szerepkör neve.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ServicePrincipalName

A szolgáltatásnév ServicePrincipalName neve.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SignInName

A felhasználó e-mail-címe vagy egyszerű felhasználóneve.

Típus:String
Aliasok:Email, UserPrincipalName
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WorkspaceName

A Synapse-munkaterület neve.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WorkspaceObject

munkaterület bemeneti objektuma, amely általában áthalad a folyamaton.

Típus:PSSynapseWorkspace
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

Bevitelek

PSSynapseWorkspace

Kimenetek

PSRoleAssignmentDetails