Commande .alter-merge policy managed_identity

Article
12/08/2023

La commande met à jour la stratégie ManagedIdentity du cluster ou de la base de données spécifiée, en ajoutant de nouvelles identités managées ou en ajoutant des utilisations aux identités managées existantes.

Notes

Les identités managées doivent être affectées à un cluster avant de pouvoir les affecter à la stratégie ManagedIdentity. Pour plus d’informations, consultez Configurer des identités managées pour votre cluster.

Autorisations

Vous devez disposer des autorisations AllDatabasesAdmin pour exécuter ces commandes.

Syntax

.alter-mergeclusterpolicymanaged_identityArrayOfPolicyObjects

.alter-mergedatabaseDatabasenamepolicymanaged_identityArrayOfPolicyObjects

Découvrez les conventions de syntaxe.

Paramètres

Nom	Type	Obligatoire	Description
DatabaseName	`string`	✔️	Nom de la base de données.
ArrayOPolicyObjects	tableau	✔️	Tableau sérialisé avec zéro ou plusieurs objets de stratégie ManagedIdentity définis.

Notes

Les objets de stratégie doivent définir les propriétés ObjectId et AllowedUsages . Les autres propriétés sont renseignées automatiquement.
Pour chaque élément dans ArrayOfManagedIdentityPolicyObjects:
- Si l’ObjectId n’existe pas dans la stratégie ManagedIdentity, l’élément est ajouté à la stratégie.
- Si l’ObjectId existe déjà dans la stratégie ManagedIdentity, la propriété AllowedUsages de l’identité est ajoutée à l’élément approprié dans la stratégie. Par exemple, si la stratégie actuelle a AllowedUsages="NativeIngestion » pour une identité managée spécifique, si ArrayOfManagedIdentityPolicyObjects a un élément pour cette identité managée avec AllowedUsages="ExternalTables », les AllowedUsages de cette identité managée dans la stratégie d’identité managée deviennent « NativeIngestion, ExternalTables ».

Obtention de l’ID d’objet d’identité managée

L’ID d’objet est disponible dans le Portail Azure sur la page de vue d’ensemble de l’identité managée.

Recherchez 'ID d’objet (principal).

Retours

La commande met à jour la stratégie ManagedIdentity du cluster ou de la base de données spécifiée. La modification peut ajouter de nouvelles identités managées ou ajouter des utilisations à des identités managées existantes. Ensuite, la commande retourne la sortie de la commande de stratégie d’identité managée .show correspondante.

Si l’une des identités managées spécifiées n’est pas affectée au cluster, une erreur est retournée et la stratégie ManagedIdentity n’est pas modifiée.

Exemple

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

Partager via