Dela via


Kommandot .alter-merge policy managed_identity

Kommandot uppdaterar ManagedIdentity-principen för klustret eller den angivna databasen, lägger till nya hanterade identiteter eller lägger till användningar i befintliga hanterade identiteter.

Anteckning

Hanterade identiteter ska tilldelas till ett kluster innan du kan tilldela dem till ManagedIdentity-principen. Mer information finns i Konfigurera hanterade identiteter för klustret

Behörigheter

Du måste ha Behörigheter för AllDatabasesAdmin för att kunna köra dessa kommandon.

Syntax

.alter-mergeclusterpolicymanaged_identityArrayOfPolicyObjects

.alter-mergedatabaseDatabasenamepolicymanaged_identityArrayOfPolicyObjects

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Obligatorisk Beskrivning
Databasename string ✔️ Namnet på databasen.
ArrayOPolicyObjects matris ✔️ En serialiserad matris med noll eller fler ManagedIdentity-principobjekt definierade.

Anteckning

  • Principobjekt måste definiera egenskaperna ObjectId och AllowedUsages . Andra egenskaper fylls i automatiskt.

  • För varje objekt i ArrayOfManagedIdentityPolicyObjects:

    • Om ObjectId inte finns i ManagedIdentity-principen läggs objektet till i principen.
    • Om ObjectId redan finns i ManagedIdentity-principen läggs identitetens egenskapen AllowedUsages till i det relevanta objektet i principen. Om den aktuella principen till exempel har AllowedUsages="NativeIngestion" för en specifik hanterad identitet, så ArrayOfManagedIdentityPolicyObjects blir allowedUsages för den hanterade identiteten i principen Hanterad identitet "NativeIngestion, ExternalTables" om den har ett objekt för den hanterade identiteten med AllowedUsages="ExternalTables".

Hämta objekt-ID:t för hanterad identitet

Objekt-ID:t är tillgängligt i Azure Portal på översiktssidan för den hanterade identiteten.

Leta efter objekt-ID (huvudnamn).

Returer

Kommandot uppdaterar ManagedIdentity-principen för klustret eller den angivna databasen. Ändringen kan lägga till nya hanterade identiteter eller lägga till användningar i befintliga hanterade identiteter. Kommandot returnerar sedan utdata från motsvarande .show managed identity policy-kommando .

Om någon av de angivna hanterade identiteterna inte har tilldelats klustret returneras ett fel och ManagedIdentity-principen ändras inte.

Exempel

.alter-merge database db policy managed_identity ```
[
  {
    "ObjectId": "d99c9846-1615-a2f9-a96f-78e136ba93eb",
    "AllowedUsages": "NativeIngestion, ExternalTable"
  }
]
```