Seuls les administrateurs de tenant peuvent créer et gérer des actions personnalisées.
Certaines connaissances en PowerShell sont nécessaires pour créer des actions personnalisées dans CoreView.
Suivez ces étapes pour créer une action personnalisée :
Étape 1 : Gérer la liste des actions personnalisées
- Développez la section “ACTIONS” dans le menu du panneau latéral.
- Cliquez sur “Gérer des actions personnalisées”.
- Cliquez sur “Ajouter un nouveau”.
Étape 2 : Assistant de configuration
Un assistant apparaît pour vous guider à travers toutes les étapes nécessaires à la création d'une action personnalisée. Dans la section “Cible”, vous avez la possibilité de définir la cible de votre action personnalisée. Sélectionnez l'une des options disponibles dans le menu déroulant.
Les tenants virtuels ne sont pas appliqués aux actions personnalisées sans cible (“Aucun”). Cela signifie que l'opérateur délégué qui exécute l'action personnalisée pourra manipuler tous les objets.
Si, par exemple, vous sélectionnez “Utilisateur” comme cible et que l'opérateur délégué fait partie d'un tenant virtuel, il ne pourra manipuler que les éléments liés aux utilisateurs basés dans les pays spécifiques autorisés par le tenant virtuel.
Après avoir sélectionné une cible spécifique, le système vous permet de définir des variables liées à cette cible. Par exemple, si “Utilisateur” est la cible sélectionnée, vous pouvez définir des variables telles que le nom d'utilisateur principal.
Étape 3 : Onglet Cible
Une fois la cible sélectionnée, vous pouvez ajouter des colonnes au tableau. Ces colonnes peuvent être filtrées en cliquant sur la zone de texte située au-dessus d'elles et en choisissant le filtre souhaité à appliquer.
Les opérateurs ne peuvent pas modifier les filtres définis par l'administrateur de tenant lors de la configuration de l'action personnalisée.
Étape 4 : Onglet Entrée
Dans l'onglet “Entrée”, vous pouvez gérer les variables. Ajoutez-les ou supprimez-les en cliquant sur les icônes situées à côté de leurs noms. Ces variables seront automatiquement intégrées au script PowerShell.
body { background-color: white; /* Ensure the iframe has a white background */ }
Étape 5 : Onglet Script
Dans l'onglet “Script”, vous devez saisir votre script PowerShell. Une fois cette opération effectuée, les paramètres et les variables seront automatiquement intégrés à votre script.
Lorsque vous adaptez un script PowerShell pour une action personnalisée, incluez uniquement la logique métier. Supprimez tout code qui se connecte à l'environnement Microsoft 365, s'en déconnecte ou le prépare.
N'incluez PAS :
- Les commandes de connexion, telles que
Connect-ExchangeOnline,Connect-MicrosoftTeams,Connect-SPOService,Connect-PnPOnlineouConnect-MgGraph. - Les commandes de déconnexion, telles que
Disconnect-ExchangeOnline,Disconnect-MicrosoftTeamsou des commandes similaires. - Les commandes de gestion de session, telles que
New-PSSessionetRemove-PSSession. - Les instructions
Import-Modulepour les modules Microsoft 365.
CoreView gère ces opérations via la Session de gestion. Avant l'exécution du script, CoreView ouvre les connexions requises.
Le script doit partir du principe que l'environnement approprié est déjà disponible et appeler directement les cmdlets requises, par exemple Get-Mailbox ou Get-MgUser.
Si l'action personnalisée nécessite uniquement des services spécifiques, déclarez-les en haut du script à l'aide de balises de canal (voir l'étape 6).
Pour obtenir des conseils et des recommandations supplémentaires sur la personnalisation de votre script PowerShell, vous pouvez consulter l'aide-mémoire des actions personnalisées.
Optimiseur de script
La fonctionnalité Optimiseur de script n'est pas disponible pour les clients hébergés dans le centre de données GOV.
L'Optimiseur de script vous permet d'intégrer des capacités d'IA à votre processus de script PowerShell. Il fournit des commentaires en temps réel sur vos scripts, avec des suggestions, des améliorations et des conseils sur les erreurs.
Fonctionnalités :
- Évaluation du script et commentaires : fournit des informations générées par l'IA pour affiner vos commandes PowerShell.
- Conseils sur les erreurs : fournit des explications détaillées et des solutions potentielles aux problèmes de script.
- Recommandations de bonnes pratiques : suggère des améliorations pour la sécurité et les performances des scripts sur la base des normes du secteur.
- Assistance interactive : offre une aide étape par étape pour le dépannage et l'affinement des scripts.
Vous avez des préoccupations concernant la sécurité de l'IA ? Consultez notre article Vue d'ensemble de la sécurité et de la confidentialité de l'IA.
Pour utiliser l'Optimiseur de script :
- Saisissez votre script PowerShell dans la zone “Script”.
- Le script apparaîtra automatiquement dans la zone “Script généré”.
- Cliquez sur le bouton “Optimiser le script”.
- La réponse de l'IA sera générée et fournira des suggestions et des améliorations.
- Modifiez votre script en fonction des suggestions.
Étape 6 : Session de gestion
Lors de l'exécution d'une action personnalisée, assurez-vous que tous les canaux de la session de gestion sont connectés ; sinon, l'action personnalisée échouera. Vous pouvez également spécifier le canal particulier requis pour l'exécution de l'action personnalisée.
Par exemple, si une action personnalisée nécessite uniquement le canal “Exchange”, il suffit d'insérer la balise suivante dans le script PowerShell :
<#
Exchange
#> Voici les valeurs possibles pour les balises :
ActiveDirectoryOnPremises
ExchangeOnPremises
MicrosoftTeams
SharePoint
MicrosoftGraphPour plus d'informations, consultez l'article sur les versions et fonctionnalités PowerShell prises en charge par CoreView.
Étape 7 : Enregistrer et prévisualiser
Vous avez maintenant la possibilité d'enregistrer votre travail comme brouillon et d'exécuter un aperçu de l'action.
La fonctionnalité d'aperçu est uniquement disponible pour l'administrateur qui crée l'action personnalisée.
Étape 8 : Soumettre pour vérification
Une fois que vous êtes prêt à soumettre l'action personnalisée, cliquez sur le bouton “Soumettre”. Notre équipe l'examinera ensuite pour s'assurer qu'il n'y a pas d'impact sur la sécurité ou les performances de la plateforme CoreView.
Veuillez noter que nous pouvons approuver ou refuser l'action personnalisée sur la base de cet examen.
Si elle est approuvée, l'état de l'action personnalisée passera à “Approuvé après vérification”. Vous pouvez vérifier l'état de vos actions personnalisées dans la colonne “État” sur la page “Gérer l'action personnalisée”.
Notification d'action personnalisée
Vous recevrez les notifications d'action personnalisée à l'adresse e-mail définie dans “Mon profil > Infos personnelles”. Les profils d'administrateur ne peuvent pas être enregistrés si le champ e-mail est manquant ou contient une adresse non valide.
Étape 9 : Publier
Une fois que l'état de votre action personnalisée passe à “Approuvé après vérification”, cliquez simplement sur “…” dans la colonne “Actions” et sélectionnez “Publier”.
Par conséquent, l'action personnalisée apparaîtra dans la liste “Gérer des actions personnalisées”, prête à être utilisée dans Workflows.
FAQ
Puis-je modifier ou supprimer une action personnalisée ?
À ce stade, une action personnalisée qui a déjà été examinée ne peut pas être modifiée ni supprimée. Toutefois, elle peut être désactivée afin de la retirer de la liste des actions personnalisées disponibles. Veuillez noter qu'une action personnalisée ne peut être modifiée ou supprimée que lorsqu'elle est à l'état de brouillon.
Quel est le rôle requis pour créer une action personnalisée ?
Seuls les opérateurs disposant de rôles d'administrateur de tenant peuvent créer une action personnalisée.
Je viens de créer une action personnalisée et elle est maintenant à l'état soumis. Qu'est-ce que cela signifie ?
Cela indique que l'équipe a reçu la demande. Dans les 24 heures, elle sera examinée pour vérifier les impacts potentiels sur la sécurité et les performances, puis approuvée ou refusée.