Set-AzSqlInstanceActiveDirectoryAdministrator

  • Referencia
Modul:
Az.Sql

Kiépít egy Microsoft Entra-rendszergazdát a felügyelt SQL-példányhoz.

Syntax

Set-AzSqlInstanceActiveDirectoryAdministrator
   [-DisplayName] <String>
   [-ObjectId] <Guid>
   [-ResourceGroupName] <String>
   [-InstanceName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSqlInstanceActiveDirectoryAdministrator
   [-DisplayName] <String>
   [-ObjectId] <Guid>
   -InputObject <AzureSqlManagedInstanceModel>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzSqlInstanceActiveDirectoryAdministrator
   [-DisplayName] <String>
   [-ObjectId] <Guid>
   [-ResourceId] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

A Set-AzSqlInstanceActiveDirectory Rendszergazda istrator parancsmag kiépít egy Microsoft Entra-rendszergazdát a felügyelt AzureSQL-példányhoz az aktuális előfizetésben. Egyszerre csak egy rendszergazdát építhet ki. A Microsoft Entra ID következő tagjai felügyelt SQL-példányok rendszergazdájaként építhetők ki:

  • A Microsoft Entra ID natív tagjai
  • A Microsoft Entra ID összevont tagjai
  • A biztonsági csoportként létrehozott Microsoft Entra-csoportok a többi Azure AD-ből importált tagokat rendszergazdaként nem támogatják. A Microsoft-fiókok, például a Outlook.com, Hotmail.com vagy Live.com tartományokban lévő fiókok nem támogatottak rendszergazdákként. Más vendégfiókok, például a Gmail.com vagy Yahoo.com tartományokban lévő fiókok nem támogatottak rendszergazdaként. Javasoljuk, hogy rendszergazdaként kiépítsen egy dedikált Microsoft Entra-csoportot.

Példák

1. példa: Rendszergazdai csoport kiépítése egy erőforráscsoporthoz társított felügyelt példányhoz

Set-AzSqlInstanceActiveDirectoryAdministrator -ResourceGroupName "ResourceGroup01" -InstanceName "ManagedInstance01" -DisplayName "DBAs" -ObjectId "40b79501-b343-44ed-9ce7-da4c8cc7353b"

ResourceGroupName InstanceName      DisplayName ObjectId 
----------------- ----------------- ----------- -------- 
ResourceGroup01   ManagedInstance01 DBAs        40b79501-b343-44ed-9ce7-da4c8cc7353b

Ez a parancs kiépít egy DbAs nevű Microsoft Entra rendszergazdai csoportot a ManagedInstance01 nevű felügyelt példányhoz. Ez a kiszolgáló a ResourceGroup01 erőforráscsoporthoz van társítva.

2. példa: Rendszergazdai felhasználó kiépítése felügyelt példányobjektum használatával

Get-AzSqlInstance -ResourceGroupName "ResourceGroup01" -InstanceName "ManagedInstance01" | Set-AzSqlInstanceActiveDirectoryAdministrator -DisplayName "David Chew" -ObjectId "11E95548-B179-4FE1-9AF4-ACA49D13ABB9"

ResourceGroupName InstanceName      DisplayName ObjectId 
----------------- ----------------- ----------- -------- 
Resourcegroup01   ManagedInstance01 David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9

Ez a parancs rendszergazdaként kiépít egy Microsoft Entra-felhasználót a felügyelt példány objektumából.

3. példa: Rendszergazda kiépítése felügyelt példány erőforrás-azonosítójával

Get-AzSqlInstance -ResourceId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/managedInstances/ManagedInstance01" | Set-AzSqlInstanceActiveDirectoryAdministrator -DisplayName "David Chew" -ObjectId "11E95548-B179-4FE1-9AF4-ACA49D13ABB9"

ResourceGroupName InstanceName      DisplayName ObjectId 
----------------- ----------------- ----------- -------- 
Resourcegroup01   ManagedInstance01 David Chew  11E95548-B179-4FE1-9AF4-ACA49D13ABB9

Ez a parancs rendszergazdaként kiépít egy Microsoft Entra-felhasználót a felügyelt példány erőforrás-azonosítójával.

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Megadja annak a felhasználónak vagy csoportnak a megjelenítendő nevét, akinek engedélyt kell adnia. Ennek a megjelenítendő névnek az aktuális előfizetéshez társított Active Directoryban kell lennie.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

A használni kívánt felügyelt példányobjektum.

Type:AzureSqlManagedInstanceModel
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstanceName

Felügyelt SQL-példány neve.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

Annak a felhasználónak vagy csoportnak az objektumazonosítóját adja meg a Microsoft Entra-azonosítóban, amelyhez engedélyeket kíván adni.

Type:Guid
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Az erőforráscsoport neve.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

A használni kívánt példány erőforrás-azonosítója

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

String

Guid

Kimenetek

AzureSqlInstanceActiveDirectoryAdministratorModel