New-AzSynapseRoleAssignment
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
Kimenetek
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: