Set-AzSynapseSqlActiveDirectoryAdministrator

Referens

Modul:: Az.Synapse

Etablerar en Microsoft Entra-administratör för Synapse Analytics SQL-pool.

Syntax

Set-AzSynapseSqlActiveDirectoryAdministrator
   [-ResourceGroupName <String>]
   -WorkspaceName <String>
   -DisplayName <String>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzSynapseSqlActiveDirectoryAdministrator
   [-ResourceGroupName <String>]
   -WorkspaceName <String>
   -ObjectId <Guid>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzSynapseSqlActiveDirectoryAdministrator
   -InputObject <PSSynapseWorkspace>
   -DisplayName <String>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzSynapseSqlActiveDirectoryAdministrator
   -InputObject <PSSynapseWorkspace>
   -ObjectId <Guid>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzSynapseSqlActiveDirectoryAdministrator
   -ResourceId <String>
   -DisplayName <String>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzSynapseSqlActiveDirectoryAdministrator
   -ResourceId <String>
   -ObjectId <Guid>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten Set-AzSynapseSqlActiveDirectoryAdministrator etablerar en Microsoft Entra-administratör för Azure Synapse Analytics-arbetsytan i den aktuella prenumerationen. Du kan bara etablera en administratör i taget. Följande medlemmar i Microsoft Entra-ID kan etableras som synapse Analytics-arbetsyteadministratör:

Interna medlemmar i Microsoft Entra-ID
Federerade medlemmar i Microsoft Entra-ID
Importerade medlemmar från andra Azure-AD:ar som är inbyggda eller federerade medlemmar
Microsoft Entra-grupper som skapats som säkerhetsgrupper Microsoft-konton, till exempel de i Outlook.com, Hotmail.com eller Live.com domäner, stöds inte som administratörer. Andra gästkonton, till exempel de i Gmail.com eller Yahoo.com domäner, stöds inte som administratörer. Vi rekommenderar att du etablerar en dedikerad Microsoft Entra-grupp som administratör.

Cmdleten kan anropa under Microsoft Graph API enligt indataparametrar:

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

Exempel

Exempel 1

Set-AzSynapseSqlActiveDirectoryAdministrator -WorkspaceName ContosoWorkspace -DisplayName "DBAs"

Det här kommandot etablerar en Microsoft Entra-administratörsgrupp med namnet DBAs för arbetsytan ContosoWorkspace.

Exempel 2

Set-AzSynapseSqlActiveDirectoryAdministrator -WorkspaceName ContosoWorkspace -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"

Det här kommandot etablerar en Microsoft Entra-administratör efter objectId för arbetsytan med namnet ContosoWorkspace.

Parametrar

-AsJob

Kör cmdlet i bakgrunden

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DisplayName

Anger visningsnamnet för den användare eller grupp som behörigheter ska beviljas för. Det här visningsnamnet måste finnas i den active directory som är associerad med den aktuella prenumerationen.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-InputObject

indataobjekt för arbetsytan, som vanligtvis skickas via pipelinen.

Typ:	PSSynapseWorkspace
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ObjectId

Anger objekt-ID för användaren eller gruppen i Microsoft Entra-ID som behörigheter ska beviljas för.

Typ:	Guid
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResourceGroupName

Namn på resursgrupp.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResourceId

Resursidentifierare för Synapse-arbetsyta.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WorkspaceName

Namnet på Synapse-arbetsytan.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

PSSynapseWorkspace

Utdata

PSWorkspaceAadAdminInfo

Dela via