Set-AzSqlInstanceActiveDirectoryAdministrator

Modul:

Az.Sql Module

Zřídí správce Microsoft Entra pro SQL Managed Instance.

Syntax

UseResourceGroupAndInstanceNameParameterSet (Výchozí)

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

UseInputObjectParameterSet

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

UserResourceIdParameterSet

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

Description

Rutina Set-AzSqlInstanceActiveDirectoryAdministrator zřídí správce Microsoft Entra pro azureSQL Managed Instance v aktuálním předplatném. Současně můžete zřídit pouze jednoho správce. Jako správce SQL Managed Instance je možné zřídit následující členy Microsoft Entra ID:

• Nativní členové Microsoft Entra ID
• Federované členy Microsoft Entra ID
• Microsoft Entra skupiny vytvořené jako skupiny zabezpečení Importované členy z jiných Azure AD nejsou podporovány jako správci. Microsoft účty, jako jsou účty v Outlook.com, Hotmail.com nebo Live.com doménách, nejsou podporovány jako správci. Jiné účty hostů, například účty Gmail.com nebo Yahoo.com domén, nejsou podporované jako správci. Doporučujeme zřídit vyhrazenou skupinu Microsoft Entra jako správce.

Příklady

Příklad 1: Zřízení skupiny správců pro spravovanou instanci přidruženou ke skupině prostředků

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

Tento příkaz zřídí Microsoft Entra skupinu správců s názvem DBA pro spravovanou instanci s názvem ManagedInstance01. Tento server je přidružený ke skupině prostředků ResourceGroup01.

Příklad 2: Zřízení uživatele správce pomocí objektu spravované instance

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

Tento příkaz zřídí Microsoft Entra uživatele jako správce z objektu spravované instance.

Příklad 3: Zřízení správce pomocí identifikátoru prostředku spravované instance

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

Tento příkaz zřídí Microsoft Entra uživatele jako správce pomocí identifikátoru prostředku spravované instance.

Parametry

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Vlastnosti parametru

Typ:	IAzureContextContainer
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DisplayName

Určuje zobrazované jméno uživatele nebo skupiny, pro které se mají udělit oprávnění. Tento zobrazovaný název musí existovat ve službě Active Directory přidružené k aktuálnímu předplatnému.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	2
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-InputObject

Objekt spravované instance, který se má použít.

Vlastnosti parametru

Typ:	AzureSqlManagedInstanceModel
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

UseInputObjectParameterSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-InstanceName

SQL Managed Instance název.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

UseResourceGroupAndInstanceNameParameterSet

Position:	1
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ObjectId

Určuje ID objektu uživatele nebo skupiny v Microsoft Entra ID, pro který se mají udělit oprávnění.

Vlastnosti parametru

Typ:	Guid
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	3
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ResourceGroupName

Název skupiny zdrojů.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

UseResourceGroupAndInstanceNameParameterSet

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ResourceId

ID prostředku instance, která se má použít

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

UserResourceIdParameterSet

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Guid

Výstupy

AzureSqlInstanceActiveDirectoryAdministratorModel

Související odkazy

• Get-AzSqlInstanceActiveDirectoryAdministrator
• Remove-AzSqlInstanceActiveDirectoryAdministrator