New-AzSynapseRoleAssignment

Başvuru

Modül:: Az.Synapse

Synapse Analytics rol ataması oluşturur.

Sözdizimi

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

New-AzSynapseRoleAssignment cmdlet'i bir Azure Synapse Analytics rol ataması oluşturur.

Cmdlet, giriş parametrelerine göre Microsoft Graph API'sinin altında çağrı yapabilir:

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

Not

Hizmet sorumlusuna rol ataması oluşturmak için ObjectId parametresinde sorumlunun nesne kimliğini geçirin. Çalışma alanında Azure RBAC rol atamasını yönetme iznine sahip ancak Synapse Yöneticisi olmayan bir kullanıcıysanız, Synapse Administrator rolünü -RoleDefinitionId ve -ObjectId ile doğrudan oluşturun, ancak -RoleDefinitionName ile oluşturun, Synapse Administrator için RoleDefinitionId "00001111-aaaa-2222-bbbb-3333cccc4444" şeklindedir, lütfen aşağıdaki Örnek 5'i başvuru olarak alın. Bunun nedeni , bir "Synapse Yöneticisi" rolü eklemeyi denediğinizde, cmdlet'in geçerli kullanıcının sahip olmadığı çalışma alanı okuma izni gerektiren rol adından rol kimliğini alması gerekir.

Örnekler

Örnek 1

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

Bu komut, asıl adı ContosoName olan kullanıcıya ContosoRole atar.

Örnek 2

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

Bu komut, asıl adı ContosoName ve öğe türü ContosoItemType, öğe ContosoItem olan kullanıcıya ContosoRole atar.

Örnek 3

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

Bu komut, asıl adı ContosoName ve öğe türü ContosoItemType, öğe ContosoItem olan kullanıcıya ContosoRole atar.

Örnek 4

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

Bu komut, contosoRole'yi asıl adı ContosoName olan kullanıcıya işlem hattı aracılığıyla atar.

Örnek 5

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

Bu komut, işlem hattı aracılığıyla nesne kimliği ContosoObjectId olan kullanıcıya Synapse Yönetici rolü atar.

Parametreler

-AsJob

Cmdlet'i arka planda çalıştırma

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:	SwitchParameter
Diğer adlar:	cf
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:	IAzureContextContainer
Diğer adlar:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Item

Çalışma alanı öğesi.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-ItemType

Çalışma alanı öğe türü.

Tür:	Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
Kabul edilen değerler:	ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-ObjectId

Kullanıcı, Grup veya Hizmet Sorumlusunun Microsoft Entra ObjectId değeri.

Tür:	String
Diğer adlar:	Id, PrincipalId
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-RoleDefinitionId

Sorumluya atanan Rolün kimliği.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-RoleDefinitionName

Sorumluya atanan Rolün adı.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-ServicePrincipalName

Hizmet sorumlusunun ServicePrincipalName değeri.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-SignInName

Kullanıcının e-posta adresi veya kullanıcı asıl adı.

Tür:	String
Diğer adlar:	Email, UserPrincipalName
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:	SwitchParameter
Diğer adlar:	wi
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-WorkspaceName

Synapse çalışma alanının adı.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-WorkspaceObject

çalışma alanı giriş nesnesi, genellikle işlem hattından geçirilir.

Tür:	PSSynapseWorkspace
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

Girişler

PSSynapseWorkspace

Çıkışlar

PSRoleAssignmentDetails

Aracılığıyla paylaş