New-AzSynapseRoleAssignment

Modul:

Az.Synapse

Membuat penetapan peran Synapse Analytics.

Sintaks

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

Deskripsi

Cmdlet New-AzSynapseRoleAssignment membuat penetapan peran Azure Synapse Analytics.

Cmdlet dapat memanggil di bawah Microsoft Graph API sesuai dengan parameter input:

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

Catatan

Untuk membuat penetapan peran untuk perwakilan layanan, teruskan ID objek prinsipal dalam parameter ObjectId. Saat Anda adalah pengguna dengan izin untuk mengelola penetapan peran Azure RBAC di ruang kerja tetapi bukan Administrator Synapse, silakan buat peran Administrator Synapse oleh -RoleDefinitionId dan -ObjectId secara langsung tetapi tidak oleh -RoleDefinitionName, untuk Administrator Synapse, RoleDefinitionId adalah "00001111-aaaa-2222-bbbb-3333cccc4444", silakan ambil contoh 5 di bawah ini sebagai referensi. Alasannya adalah , ketika Anda mencoba menambahkan peran "Administrator Synapse", cmdlet perlu mendapatkan ID peran dari nama peran yang memerlukan izin baca ruang kerja, yang tidak dimiliki pengguna saat ini.

Contoh

Contoh 1

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

Perintah ini menetapkan ContosoRole kepada pengguna yang nama utamanya adalah ContosoName.

Contoh 2

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

Perintah ini menetapkan ContosoRole kepada pengguna yang nama utamanya adalah ContosoName dan jenis itemnya adalah ContosoItemType, item adalah ContosoItem.

Contoh 3

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

Perintah ini menetapkan ContosoRole kepada pengguna yang nama utamanya adalah ContosoName dan jenis itemnya adalah ContosoItemType, item adalah ContosoItem.

Contoh 4

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

Perintah ini menetapkan ContosoRole kepada pengguna yang nama utamanya adalah ContosoName melalui alur.

Contoh 5

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

Perintah ini menetapkan peran Administrator Synapse kepada pengguna yang ID objeknya adalah ContosoObjectId melalui alur.

Parameter

-AsJob

Jalankan cmdlet di latar belakang

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Item

Item ruang kerja.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ItemType

Jenis item ruang kerja.

Jenis:	Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+WorkspaceItemType
Nilai yang diterima:	ApacheSparkPool, IntegrationRuntime, LinkedService, Credential
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ObjectId

Microsoft Entra ObjectId dari Pengguna, Grup, atau Perwakilan Layanan.

Jenis:	String
Alias:	Id, PrincipalId
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-RoleDefinitionId

Id Peran yang ditetapkan ke prinsipal.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-RoleDefinitionName

Nama Peran yang ditetapkan ke prinsipal.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-ServicePrincipalName

ServicePrincipalName dari perwakilan layanan.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-SignInName

Alamat email atau nama utama pengguna pengguna.

Jenis:	String
Alias:	Email, UserPrincipalName
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:	SwitchParameter
Alias:	wi
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-WorkspaceName

Nama ruang kerja Synapse.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-WorkspaceObject

objek input ruang kerja, biasanya melewati alur.

Jenis:	PSSynapseWorkspace
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

Input

PSSynapseWorkspace

Output

PSRoleAssignmentDetails