New-AzSynapseRoleAssignment

Odwołanie

Moduł:: Az.Synapse

Tworzy przypisanie roli usługi Synapse Analytics.

Składnia

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>]

Opis

Polecenie cmdlet New-AzSynapseRoleAssignment tworzy przypisanie roli usługi Azure Synapse Analytics.

Polecenie cmdlet może wywołać poniższy interfejs API programu Microsoft Graph zgodnie z parametrami wejściowymi:

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

Uwaga

Aby utworzyć przypisanie roli dla jednostki usługi, przekaż identyfikator obiektu jednostki w parametrze ObjectId. Gdy jesteś użytkownikiem z uprawnieniami do zarządzania przypisaniem roli RBAC platformy Azure w obszarze roboczym, ale nie administratorem usługi Synapse, Utwórz rolę administratora usługi Synapse według parametrów -RoleDefinitionId i -ObjectId bezpośrednio, ale nie według parametru -RoleDefinitionName, dla administratora usługi Synapse identyfikator RoleDefinitionId to "00001111-aaaa-2222-bbbb-333cccc44444", skorzystaj z poniższego przykładu 5 jako odwołania. Przyczyną jest to, że podczas próby dodania roli "Administrator usługi Synapse" polecenie cmdlet musi uzyskać identyfikator roli z nazwy roli, która wymaga uprawnienia do odczytu obszaru roboczego, którego bieżący użytkownik nie ma.

Przykłady

Przykład 1

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

To polecenie przypisuje contosoRole do użytkownika, którego główną nazwą jest ContosoName.

Przykład 2

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

To polecenie przypisuje contosoRole do użytkownika, którego główna nazwa to ContosoName, a typ elementu to ContosoItemType, element to ContosoItem.

Przykład 3

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

To polecenie przypisuje contosoRole do użytkownika, którego główna nazwa to ContosoName, a typ elementu to ContosoItemType, element to ContosoItem.

Przykład 4

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

To polecenie przypisuje contosoRole do użytkownika, którego główna nazwa to ContosoName za pośrednictwem potoku.

Przykład 5

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

To polecenie przypisuje użytkownikowi rolę administratora usługi Synapse, którego identyfikator obiektu to ContosoObjectId za pośrednictwem potoku.

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Item

Element obszaru roboczego.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ItemType

Typ elementu obszaru roboczego.

Typ:	Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
Dopuszczalne wartości:	ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ObjectId

Identyfikator ObjectId firmy Microsoft użytkownika, grupy lub jednostki usługi.

Typ:	String
Aliasy:	Id, PrincipalId
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-RoleDefinitionId

Identyfikator roli przypisanej do podmiotu zabezpieczeń.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-RoleDefinitionName

Nazwa roli przypisanej do podmiotu zabezpieczeń.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ServicePrincipalName

ServicePrincipalName jednostki usługi.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SignInName

Adres e-mail lub główna nazwa użytkownika użytkownika.

Typ:	String
Aliasy:	Email, UserPrincipalName
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-WorkspaceName

Nazwa obszaru roboczego usługi Synapse.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-WorkspaceObject

obiekt wejściowy obszaru roboczego, zwykle przekazywany przez potok.

Typ:	PSSynapseWorkspace
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

PSSynapseWorkspace

Dane wyjściowe

PSRoleAssignmentDetails

Udostępnij za pośrednictwem