Prise en charge de PowerShell pour Power Apps

Avec les applets de commande PowerShell pour les créateurs et les administrateurs d’applications, vous pouvez automatiser de nombreuses tâches de surveillance et de gestion qui ne sont possibles que manuellement aujourd’hui dans Power Apps.

Applets de commande

Les applets de commande désignent des fonctions écrites dans le langage de script PowerShell qui exécutent des commandes dans l'environnement Windows PowerShell. Exécuter les applets de commande Power Apps vous permettra d’interagir avec votre plateforme d’application d’entreprise sans devoir passer via le portail d’administration dans un navigateur Web. Vous pouvez combiner ces applets de commande avec d’autres fonctions PowerShell pour saisir des scripts complexes qui peuvent optimiser votre workflow. Notez que vous pouvez toujours utiliser les applets de commande si vous n’êtes pas un administrateur sur le client, mais vous serez limité aux ressources qui vous appartiennent. Les applets de commande qui commencent par le mot « Administrateur » sont conçus pour être utilisés par un compte d’administrateur sur l’ordinateur.

Les applets de commande sont disponibles dans PowerShell Gallery comme deux modules distincts :

Pour plus d'informations sur le module d'administration Power Apps, voir Commencer à utiliser le module d'administration Power Apps et Microsoft.PowerApps.Administration.PowerShell.

Notes

Concernant le support de niveau 2 du cloud communautaire de Dynamics 365 Government :

Le point de terminaison par défaut est « prod ». Si un utilisateur souhaite exécuter un script PowerShell ciblant un environnement GCC, le paramètre -Endpoint doit être modifié en « usgov » pour GCC Moderate, ou « usgovhigh » pour GCC High, ou « dod » pour GCC DOD.

Add-PowerAppsAccount -Endpoint "usgov" 

Configuration requise

PowerShell dans cette rubrique nécessite PowerShell version 5.x. Pour vérifier la version de PowerShell exécutée sur votre ordinateur, exécutez la commande suivante :

$PSVersionTable.PSVersion

Si vous avez une version obsolète, voir Mise à niveau de la version existante de Windows PowerShell.

Important

Les modules décrits dans ce document utilisent .NET Framework. Cela le rend incompatible avec PowerShell 6.0 et versions ultérieures, qui utilisent .NET Core.

Installation

Pour exécuter les applets de commande PowerShell pour les créateurs d’application, procédez comme suit :

  1. Exécutez PowerShell en tant qu’administrateur.

    Exécuter PowerShell en tant qu’administrateur

  2. Importez les modules nécessaires à l’aide des commandes suivantes :

    Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
    Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber
    

    Alternativement, si vous n’avez pas de droits d’administrateur sur votre ordinateur, vous pouvez utiliser les éléments suivants pour utiliser ces modules :

    Save-Module -Name Microsoft.PowerApps.Administration.PowerShell -Path
    Import-Module -Name Microsoft.PowerApps.Administration.PowerShell
    Save-Module -Name Microsoft.PowerApps.PowerShell -Path
    Import-Module -Name Microsoft.PowerApps.PowerShell
    
  3. Si vous êtes invité à accepter la modification de la valeur par la valeur InstallationPolicy du référentiel, acceptez [A] Oui pour tous les modules en saisissant « A » et en appuyant sur Entrée pour chaque module.

    Acceptez la valeur InstallationPolicy

  4. Avant d’accéder aux commandes, vous avez la possibilité de fournir vos informations d’identification à l’aide de la commande suivante. Ces informations d’identification sont actualisées pour un nombre maximal de ~8 heures avant que vous ne deviez vous reconnecter pour continuer à utiliser les applets de commande.

    # This call opens prompt to collect credentials (Azure Active Directory account and password) used by the commands 
    Add-PowerAppsAccount
    
    # Here is how you can pass in credentials (avoiding opening a prompt)
    $pass = ConvertTo-SecureString "password" -AsPlainText -Force
    Add-PowerAppsAccount -Username user@contoso.com -Password $pass
    

Applets de commande Power Apps pour les créateurs d’application

Éléments requis

Les utilisateurs disposant d’une licence Power Apps valide peuvent exécuter les opérations dans ces applets de commande, mais ils auront uniquement accès aux ressources (par exemple, applications, flux., etc.) qui ont été créées ou partagées avec eux.

Liste des applets de commande - Applets de commande pour créateur d’applications

Notes

Nous avons mis à jour certains noms de fonction des applets de commande dans la toute dernière version afin d’ajouter des préfixes appropriés pour éviter les collisions. Consultez le tableau ci-dessous pour une vue d’ensemble de ce qui a changé.

Objectif Applet de commande
Ajouter une application canevas à une solution Microsoft Dataverse Set-PowerAppAsSolutionAware
Lire les environnements Get-PowerAppEnvironment (précédemment Get-PowerAppsEnvironment)
Get-FlowEnvironment
Lire, mettre à jour et supprimer une application canevas Get-PowerApp (précédemment Get-App)
Remove-PowerApp (précédemment Remove-App)
Publish-PowerApp (précédemment Publish-App)
Set-AppDisplayName (précédemment Set-PowerAppDisplayName)
Get-PowerAppVersion (précédemment Get-AppVersion)
Restore-PowerAppVersion (précédemment Restore-AppVersion)
Lire, mettre à jour et supprimer des autorisations d’application canevas Get-PowerAppRoleAssignment (précédemment Get-AppRoleAssignment)
Set-PowerAppRoleAssignment (précédemment Set-AppRoleAssignment)
Remove-PowerAppRoleAssignment (précédemment Remove-AppRoleAssignment)
Lire, mettre à jour et supprimer un flux Get-Flow
Get-FlowRun
Enable-Flow
Disable-Flow
Remove-Flow
Lire, mettre à jour et supprimer des autorisations de flux Get-FlowOwnerRole
Set-FlowOwnerRole
Remove-FlowOwnerRole
Lire et répondre aux approbations de flux Get-FlowApprovalRequest
Get-FlowApproval
RespondTo-FlowApprovalRequest
Lire et supprimer les connexions Get-PowerAppConnection (précédemment Get-Connection)
Remove-PowerAppConnection (précédemment Remove-Connection)
Lire, mettre à jour et supprimer des autorisations de connexion Get-PowerAppConnectionRoleAssignment (précédemment Get-ConnectionRoleAssignment)
Set-PowerAppConnectionRoleAssignment (précédemment Set-ConnectionRoleAssignment)
Remove-PowerAppConnectionRoleAssignment (précédemment Remove-ConnectionRoleAssignment)
Lire et supprimer des connecteurs Get-PowerAppConnector (précédemment Get-Connector)
Remove-PowerAppConnector (précédemment Remove-Connector)
Ajouter, lire, mettre à jour et supprimer des autorisations de connecteur personnalisées Get-PowerAppConnectorRoleAssignment (précédemment Get-ConnectorRoleAssignment)
Set-PowerAppConnectorRoleAssignment (précédemment Set-ConnectorRoleAssignment)
Remove-PowerAppConnectorRoleAssignment (précédemment Remove-ConnectorRoleAssignment)
Lire, ajouter et supprimer des modèles d’URL de stratégie Get-PowerAppPolicyUrlPatterns
New-PowerAppPolicyUrlPatterns
Remove-PowerAppPolicyUrlPatterns
Lire, enregistrer et supprimer des applications de gestion Get-PowerAppManagementApp
Get-PowerAppManagementApps
New-PowerAppManagementApp
Remove-PowerAppManagementApp
Lire, créer, mettre à jour et importer des clés de protection Get-PowerAppRetrieveAvailableTenantProtectionKeys
Get-PowerAppGenerateProtectionKey
Get-PowerAppRetrieveTenantProtectionKey
New-PowerAppImportProtectionKey
Set-PowerAppTenantProtectionKey

Applets de commande Power Apps pour les administrateurs

Éléments requis

Pour exécuter les opérations d’administration dans les applets de commande des administrateurs, définissez les informations suivantes :

  • Un utilisateur avec l’un de ces rôles, les administrateurs globaux, les administrateurs globaux Azure Active Directory ou l’administrateur Dynamics 365, peuvent accéder aux applets de commande PowerShell de l’administrateur Power Apps. Ces rôles ne nécessitent plus de plan Power Apps pour accéder administrativement aux applets de commande PowerShell pour les administrateurs Power Apps. Toutefois, ces administrateurs doivent se connecter au centre d’administration Power Platform au moins une fois avant d’utiliser les applets de commande PowerShell. Si celui-ci n’est pas fait, les applets de commande échoueront avec une erreur d’autorisation.

  • Autorisations d'administrateur global Microsoft 365 ou d'administrateur global Azure Active Directory, ou d'administrateur Dynamics 365 si vous avez besoin de rechercher dans les ressources d'un autre utilisateur. Notez que seuls les administrateurs de l’environnement ont accès à ces environnements et ressources d’environnement pour lesquels ils ont des autorisations.

Liste des applets de commande - Applets de commande pour administrateur

Objectif Applets de commande
Lire, mettre à jour, supprimer, verrouiller, déverrouiller et récupérer des environnements et des bases de données Dataverse New-AdminPowerAppEnvironment
Set-AdminPowerAppEnvironmentDisplayName
Get-AdminPowerAppEnvironment (précédemment Get-AdminEnvironment)
Remove-AdminPowerAppEnvironment (précédemment Remove-AdminEnvironment)
Get-AdminPowerAppSoftDeletedEnvironment
Recover-AdminPowerAppEnvironment
Copy-PowerAppEnvironment
Backup-PowerAppEnvironment
Get-PowerAppEnvironmentBackups
Restore-PowerAppEnvironment
Remove-PowerAppEnvironmentBackup
Reset-PowerAppEnvironment
New-AdminPowerAppCdsDatabase
Get-AdminPowerAppCdsDatabaseLanguages
Get-AdminPowerAppCdsDatabaseCurrencies
Get-AdminPowerAppEnvironmentLocations
Set-PowerAppLockAllEnvironments
Set-PowerAppUnlockEnvironment
Set-PowerAppProtectionStatus
Supprimer l’ancienne base de données de Common Data Service v1 Remove-LegacyCDSDatabase
Lire, mettre à jour et supprimer des autorisations d’environnement

Actuellement, ces applets de commande ne fonctionnent que pour les environnements qui n’ont pas de base de données Dataverse.
Get-AdminPowerAppEnvironmentRoleAssignment (précédemment Get-AdminEnvironmentRoleAssignment)
Set-AdminPowerAppEnvironmentRoleAssignment (précédemment Set-AdminEnvironmentRoleAssignment)
Remove-AdminPowerAppEnvironmentRoleAssignment (précédemment Remove-AdminEnvironmentRoleAssignment)
Set-AdminPowerAppEnvironmentRuntimeStat
Lire, mettre à jour, supprimer et récupérer des applications canevas Get-AdminPowerApp (précédemment Get-AdminApp)
Remove-AdminPowerApp (précédemment Remove-AdminApp)
Get-AdminPowerAppConnectionReferences
Set-AdminPowerAppAsFeatured
Clear-AdminPowerAppAsFeatured
Set-AdminPowerAppAsHero
Clear-AdminPowerAppAsHero
Set-AdminPowerAppApisToBypassConsent
Clear-AdminPowerAppApisToBypassConsent
Get-AdminDeletedPowerAppsList
Get-AdminRecoverDeletedPowerApp
Lire, mettre à jour et supprimer des autorisations d’application canevas Get-AdminPowerAppRoleAssignment (précédemment Get-AdminAppRoleAssignment)
Remove-AdminPowerAppRoleAssignment (précédemment Remove-AdminAppRoleAssignment)
Set-AdminPowerAppRoleAssignment (précédemment Set-AdminAppRoleAssignment)
Set-AdminPowerAppOwner (précédemment Set-AdminAppOwner)
Lire, mettre à jour et supprimer des flux Get-AdminFlow
Enable-AdminFlow
Disable-AdminFlow
Remove-AdminFlow
Remove-AdminFlowApprovals
Lire, mettre à jour et supprimer des autorisations de flux Get-AdminFlowOwnerRole
Set-AdminFlowOwnerRole
Remove-AdminFlowOwnerRole
Lire et supprimer les connexions Get-AdminPowerAppConnection (précédemment Get-AdminConnection)
Remove-AdminPowerAppConnection (précédemment Remove-AdminConnection)
Lire, mettre à jour et supprimer des autorisations de connexion Get-AdminPowerAppConnectionRoleAssignment (précédemment Get-AdminConnectionRoleAssignment)
Set-AdminPowerAppEnvironmentConnectionRoleAssignment (précédemment Set-AdminConnectionRoleAssignment)
Remove-AdminPowerAppConnectionRoleAssignment (précédemment Remove-AdminConnectionRoleAssignment)
Lire et supprimer les connecteurs personnalisés Get-AdminPowerAppConnector (précédemment Get-AdminConnector)
Remove-AdminPowerAppConnector (précédemment Remove-AdminConnector)
Lire, mettre à jour et supprimer des autorisations de connecteur personnalisé Get-AdminPowerAppConnectorRoleAssignment (précédemment Get-AdminConnectorRoleAssignment)
Set-AdminPowerAppConnectorRoleAssignment (précédemment Set-AdminConnectorRoleAssignment)
Remove-AdminPowerAppConnectorRoleAssignment (précédemment Remove-AdminConnectorRoleAssignment)
Lire les paramètres d’utilisateur, paramètres d’utilisateur-d’application et notifications Power Apps Get-AdminPowerAppsUserDetails
Lire et supprimer les paramètres Power Automate d’un utilisateur, non visibles à l’utilisateur, mais qui prennent en charge l’exécution du flux Get-AdminFlowUserDetails
Remove-AdminFlowUserDetails
Créez, lisez, mettez à jour et supprimez des stratégies de prévention de la perte de données pour votre organisation à l’aide d’une classification tridirectionnelle : Professionnel, Non professionnel et Bloqué Get-DlpPolicy (précédemment Get-AdminDlpPolicy)
New-DlpPolicy (précédemment Add-AdminDlpPolicy)
Remove-DlpPolicy (précédemment Remove-AdminDlpPolicy)
Set-DlpPolicy (précédemment Set-AdminDlpPolicy)

En savoir plus sur le SDK de protection contre la perte de données (DLP) de Microsoft Power Platform.
Lire, ajouter, mettre à jour et supprimer les paramètres de prévention contre la perte de données du client Get-PowerAppDlpErrorSettings
New-PowerAppDlpErrorSettings
Remove-PowerAppDlpErrorSettings
Set-PowerAppDlpErrorSettings
Lire, ajouter, mettre à jour et supprimer les ressources exemptées pour les stratégies DLP Get-PowerAppDlpPolicyExemptResources
New-PowerAppDlpPolicyExemptResources
Set-PowerAppDlpPolicyExemptResources
Remove-PowerAppDlpPolicyExemptResources
Lire, ajouter, supprimer et mettre à jour les paramètres du client Get-TenantSettings
Set-TenantSettings
Get-PowerAppTenantUrlPatterns
New-PowerAppTenantUrlPatterns
Remove-PowerAppTenantUrlPatterns
Get-AdminPowerAppTenantConsumedQuota
Lire, ajouter et supprimer les plans de consentement/d’évaluation autorisés au sein du client Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans
Lire les licences d’utilisateur attribuées au client Get-AdminPowerAppLicenses
Lire, mettre à jour et réinitialiser l’environnement utilisé par Power Apps pour enregistrer les applications de formulaire SharePoint Get-AdminPowerAppSharepointFormEnvironment
Set-AdminPowerAppSharepointFormEnvironment
Reset-AdminPowerAppSharepointFormEnvironment
Lire le statut de l’opération Get-AdminPowerAppOperationStatus
Lire et mettre à jour le statut d’isolement et la stratégie des locataires Get-PowerAppTenantIsolationOperationStatus
Get-PowerAppTenantIsolationPolicy
Set-PowerAppTenantIsolationPolicy

Conseils

  • Utilisez Get-Help ’CmdletName’ pour obtenir une liste d’exemples.

    Commande Get-Help

  • Pour faire défiler les choix possibles pour les balises en entrée, cliquez sur la touche Tab après avoir tapé le tiret (-) derrière le nom de l’applet de commande.

Exemples de commande :

Get-Help Get-AdminPowerAppEnvironment
Get-Help Get-AdminPowerAppEnvironment -Examples
Get-Help Get-AdminPowerAppEnvironment -Detailed

Exemples d’opération

Ci-dessous vous trouverez certains scénarios courants qui présentent comment utiliser les applets de commande Power Apps existants ainsi que les nouveaux.

Commandes d’environnements

Utilisez ces commandes de obtenir des informations détaillées sur les environnements et les mettre à jour dans votre client.

Afficher une liste de tous les environnements

Get-AdminPowerAppEnvironment

Renvoie une liste de chaque environnement de votre client, avec les détails pour chacun (par exemple, nom de l’environnement (GUID), nom d’affichage, emplacement, créateur, etc).

Afficher les détails de votre environnement par défaut

Get-AdminPowerAppEnvironment –Default

Renvoie les détails uniquement de l’environnement par défaut du client.

Détails de l’affichage d’un environnement spécifique

Get-AdminPowerAppEnvironment –EnvironmentName 'EnvironmentName'

Remarque : Le champ EnvironmentName est un identificateur unique, qui est différent du champ DisplayName (voir les premier et deuxième champs de la sortie sur l’image suivante).

Commande Get-AdminEnvironment

Commandes Power Apps

Ces opérations sont utilisées pour lire et modifier les données Power Apps dans votre client.

Afficher une liste de tous les Power Apps

Get-AdminPowerApp

Renvoie une liste de chaque Power Apps de votre client, avec les détails pour chacun (par exemple, nom de l’application (GUID), nom d’affichage, emplacement, créateur, etc).

Afficher une liste de tous les Power Apps qui correspondent au nom d’affichage en entrée

Get-AdminPowerApp 'DisplayName'

Renvoie une liste de tous les Power Apps de votre client qui correspondent au nom d’affichage.

Remarque : Utilisez les caractères de guillemets (« ») autour des valeurs d’entrée qui contiennent des espaces.

Mettre une application à la une

Set-AdminPowerAppAsFeatured –AppName 'AppName'

Les applications mises à la une sont regroupées et placées en haut de la liste du lecteur mobile Power Apps.

Remarque : comme les environnements, le champ AppName est un identificateur unique, qui est différent du champ DisplayName. Si vous souhaitez exécuter des opérations selon le nom d’affichage, certaines fonctions vous permettront utiliser le pipeline (voir la fonction suivante).

Faire d’une application une application de référence à l’aide du pipeline

Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero

Une application de référence s’affichera en haut de la liste dans le lecteur mobile Power Apps. Il ne peut exister qu’une seule application de référence.

Le pipeline, représenté par le caractère « | » entre deux applets de commande, prend le résultat du premier applet de commande et le transmet comme valeur d’entrée du deuxième, si la fonction a été saisie pour s’adapter à la fonctionnalité de pipeline.

Remarque : avant de devenir une application de référence, l’application doit déjà être une application à la une.

Afficher le nombre d’applications que chaque utilisateur possède

Get-AdminPowerApp | Select –ExpandProperty Owner | Select –ExpandProperty displayname | Group

Vous pouvez combiner les fonctions PowerShell natives avec les applets de commande Power Apps pour manipuler des données encore davantage. Ici nous utilisons la fonction Sélectionner pour isoler l’attribut Propriétaire (un objet) de l’objet Get-AdminApp. Nous isolons ensuite le nom de l’objet du propriétaire en introduisant cette sortie dans une autre fonction Sélectionner. Enfin, en transmettant la sortie de la deuxième fonction Sélectionner dans la fonction Groupe, un joli tableau apparaît avec le total des applications pour chaque propriétaire.

Commande Get-AdminPowerApp

Afficher le nombre d’applications dans chaque environnement

Get-AdminPowerApp | Select -ExpandProperty EnvironmentName | Group | %{ New-Object -TypeName PSObject -Property @{ DisplayName = (Get-AdminPowerAppEnvironment -EnvironmentName $_.Name | Select -ExpandProperty displayName); Count = $_.Count } }

Get-AdminPowerApp environment

Télécharger les détails d’utilisateur Power Apps

Get-AdminPowerAppsUserDetails -OutputFilePath '.\adminUserDetails.txt' –UserPrincipalName 'admin@bappartners.onmicrosoft.com'

La commande ci-dessus stockera les détails d’utilisateur Power Apps (informations relatives à l’utilisation de base concernant l’utilisateur en entrée via leur nom d’utilisateur principal) dans le fichier texte spécifié. Elle génèrera un nouveau fichier s’il n’y en a pas déjà un avec ce nom, et remplacera le fichier texte s’il existe déjà.

Exporter une liste des licences utilisateur attribuées

Get-AdminPowerAppLicenses -OutputFilePath '<licenses.csv>'

Exporte toutes les licences utilisateur attribuées (Power Apps et Power Automate) dans votre client dans un fichier .csv de vue tabulaire. Le fichier exporté contient à la fois des plans d’évaluation internes d’inscription en libre-service ainsi que des plans provenant d’Azure Active Directory. Les plans d’évaluation internes ne sont pas visibles par les administrateurs dans le centre d’administration Microsoft 365.

L’exportation peut prendre un certain temps pour les clients avec un grand nombre d’utilisateurs Microsoft Power Platform.

Définir l’utilisateur connecté comme le propriétaire d’une application canevas.

Set-AdminPowerAppOwner –AppName 'AppName' -AppOwner $Global:currentSession.userId –EnvironmentName 'EnvironmentName'

Permet de modifier le rôle de propriétaire d’un environnement PowerApp avec l’utilisateur actuel, et remplace le propriétaire d’origine comme rôle de type « Vue accessible ».

Remarque : les champs AppName et EnvironmentName fields sont les identificateurs uniques (GUID) et non les noms d’affichage.

Afficher une liste des applications canevas supprimées dans un environnement

Get-AdminDeletedPowerAppsList -EnvironmentName 'EnvironmentName'

Cela affiche toutes les applications canevas qui ont été récemment supprimées et peuvent encore être récupérées.

Récupérer une application canevas supprimée

Get-AdminRecoverDeletedPowerApp -AppName 'AppName' -EnvironmentName 'EnvironmentName'

Cela récupère une application canevas détectable via l’applet de commande Get-AdminDeletedPowerAppsList. Toute application canevas qui n’est pas affichée dans Get-AdminDeletedPowerAppsList n’est pas récupérable.

Désigner l’environnement de formulaire personnalisé SharePoint

Les applets de commande suivantes peuvent être utilisées pour spécifier et vérifier quels formulaires personnalisés d’environnement SharePoint y sont enregistrés, au lieu de l’environnement par défaut. Lorsque l’environnement désigné pour les formulaires personnalisés SharePoint change, il s’agit de l’environnement dans lequel les formulaires personnalisés nouvellement créés sont enregistrés. Les formulaires personnalisés existants ne migrent pas automatiquement vers différents environnements lorsque ces applets de commande sont utilisées. La possibilité pour un utilisateur de créer un formulaire personnalisé dans un environnement désigné nécessite que cet utilisateur ait le rôle de créateur d’environnement. Les utilisateurs peuvent se voir attribuer le rôle de créateur d’environnement dans le centre d’administration Power Platform.

Notez que tout environnement qui n’est pas l’environnement par défaut peut être supprimé. Si l’environnement de formulaire personnalisé SharePoint désigné est supprimé, les formulaires personnalisés sont supprimés avec lui.

Get-AdminPowerAppSharepointFormEnvironment  

Cela renvoie EnvironmentName pour l’environnement actuellement désigné pour les nouveaux formulaires personnalisés SharePoint. Si aucun environnement n’est désigné, l’environnement par défaut est renvoyé.

Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName' 

Cela désigne les formulaires personnalisés SharePoint nouvellement créés dans lesquels effectuer l’enregistrement, au lieu de l’environnement par défaut. Les formulaires personnalisés existants ne migrent pas automatiquement vers l’environnement nouvellement désigné. Seuls les environnements de production peuvent être désignés pour les formulaires personnalisés SharePoint.

Reset-AdminPowerAppSharepointFormEnvironment  

Cela réinitialise l’environnement par défaut en tant q’environnement désigné pour enregistrer les formulaires personnalisés SharePoint.

Afficher le paramètre du client pour pouvoir partager des applications avec "Tout le monde"

$settings = Get-TenantSettings 
$settings.PowerPlatform.PowerApps.disableShareWithEveryone 

Ce paramètre contrôle si les utilisateurs avec le créateur d'environnement rôle de sécurité peuvent partager des applications de canevas avec "Tout le monde dans une organisation". Lorsque le paramètre est défini sur "false", seuls les utilisateurs avec un rôle d'administrateur (administrateur Dynamics 365, Administrateur de service Power Platform, Administrateur de client Azure AD) peut partager des applications avec "Tout le monde dans une organisation".

Notez que, indépendamment de ces paramètres de client, les créateurs de valeur disposant du privilège de partage peuvent partager des applications avec des groupes de sécurité de toute taille. Ce contrôle détermine uniquement si le raccourci "Tout le monde" peut être utilisé lors du partage.

Modifier le paramètre du client pour pouvoir partager des applications avec "Tout le monde"

$settings = Get-TenantSettings 
$settings.powerPlatform.powerApps.disableShareWithEveryone = $True 
Set-TenantSettings -RequestBody $settings
Afficher le contenu du message d'erreur de gouvernance de votre organisation

Si vous spécifiez que le contenu du message d'erreur de gouvernance doit apparaître dans les messages d'erreur, il sera inclus dans le message d'erreur affiché lorsque les créateurs constatent qu'ils ne sont pas autorisés à partager des applications avec "Tout le monde". Voir Commandes de contenu des messages d'erreur de gouvernance PowerShell..

Commandes Power Automate

Utilisez ces commandes pour afficher et modifier les données relatives à Power Automate.

Afficher tous le flux

Get-AdminFlow

Renvoie une liste de tous les flux du client.

Afficher les détails du rôle de propriétaire de flux

Get-AdminFlowOwnerRole –EnvironmentName 'EnvironmentName' –FlowName 'FlowName'

Renvoie les détails de propriétaire du flux spécifié.

Remarque : comme les Environnements et PowerApps, le champ FlowName est l’identificateur unique (GUID), qui est différent du nom d’affichage du flux.

Afficher les détails de l’utilisateur de flux

Get-AdminFlowUserDetails –UserId $Global:currentSession.userId

Renvoie les informations détaillées de l’utilisateur concernant l’utilisation du flux. Dans cet exemple, nous utilisons l’identifiant utilisateur de l’utilisateur actuellement connecté à la session de PowerShell comme entrée.

Supprimer les détails de l’utilisateur de flux

Remove-AdminFlowUserDetails –UserId 'UserId'

Supprime complètement les informations détaillées sur un utilisateur de flux de la base de données Microsoft. Tous les flux qu’un utilisateur en entrée possède doivent être supprimés avant que les informations détaillées relatives à l’utilisateur des flux puissent être supprimées à leur tour.

Remarque : Le champ UserId est l’identifiant d’objet de l’enregistrement Azure Active Directory de l’utilisateur, qui est disponible dans le portail Azure sous Azure Active Directory > Utilisateurs > Profil > ID d’objet. Vous devez être un administrateur pour accéder à ces données ici.

Exporter tous les flux dans un fichier CSV

Get-AdminFlow | Export-Csv -Path '.\FlowExport.csv'

Exporte tous les flux de votre client dans un fichier de type .CSV.

Commandes de connexion de l’API

Afficher et gérer les connexions à l’API dans votre client.

Afficher toutes les connexions natives dans votre environnement par défaut

Get-AdminPowerAppEnvironment -Default | Get-AdminPowerAppConnection

Affiche une liste de toutes les connexions à l’API que vous avez dans l’environnement par défaut. Les connexions natives sont disponibles sous l’onglet Données > Connexions sur le portail du créateur.

Afficher tous les connecteurs personnalisés dans le client

Get-AdminPowerAppConnector

Renvoie une liste de tous les détails de connecteurs personnalisés du client.

Commandes de la stratégie de prévention contre la perte de données (DLP)

Notes

La possibilité de bloquer les connecteurs à l’aide d’une classification à trois voies — Métier, Hors métier et Bloqué — en plus de la prise en charge de l’interface utilisateur de la stratégie DLP dans le Centre d’administration Power Platform est actuellement en préversion publique. Il existe une nouvelle prise en charge PowerShell de la stratégie DLP pour la classification des stratégies DLP à trois voies, qui est également en préversion publique. Prise en charge de la stratégie DLP héritée pour la classification bidirectionnelle (Métier et Hors métier), ainsi que l’interface utilisateur du centre d’administration et la prise en charge de PowerShell pour la classification bidirectionnelle, sont actuellement généralement disponibles et continueront d’être disponibles dans un avenir prévisible. Plus d’informations : Documentation sur les connecteurs

Ces applets de commande contrôlent les stratégies DLP sur votre locataire.

Créer une stratégie DLP

New-DlpPolicy

Crée une nouvelle stratégie DLP pour le locataire de l’administrateur connecté.

Récupérer une liste d’objets DLP

Get-DlpPolicy

Obtenir des objets de stratégie pour le client de l’administrateur connecté.

Mettre à jour une stratégie DLP

Set-DlpPolicy

Met à jour les détails de la stratégie, tels que le Nom d’affichage de la stratégie.

Supprimer une stratégie

Remove-DlpPolicy

Supprime une stratégie DLP.

Commandes de contenu des messages d'erreur de gouvernance

Les applets de commande suivantes peuvent être utilisées pour diriger vos utilisateurs finaux vers les documents de référence sur la gouvernance de votre organisation, y compris un lien vers la documentation de gouvernance et un contact de gouvernance, lorsqu'ils sont invités par les contrôles de gouvernance. Par exemple, lorsque le contenu du message d'erreur de gouvernance est défini, il apparaîtra dans les Messages d'application de la stratégie de prévention de la perte de données Power Apps.

Définir le contenu des messages d'erreur de gouvernance

New-PowerAppDlpErrorSettings -TenantId 'TenantId' -ErrorSettings @{  
  ErrorMessageDetails = @{ 
    enabled = $True  
    url = "https://contoso.org/governanceMaterial" 
  } 
  ContactDetails= @{  
    enabled = $True 
    email = "admin@contoso.com" 
  } 
} 

L'URL et l'e-mail du message d'erreur de gouvernance peuvent être affichés indépendamment ou ensemble. La présence de chaque valeur dans le message d'erreur de gouvernance est contrôlée par le champ "activé".

Afficher le contenu des messages d'erreur de gouvernance

Get-PowerAppDlpErrorSettings -TenantId 'TenantId' 

Mettre à jour le contenu des messages d'erreur de gouvernance

Set-PowerAppDlpErrorSettings -TenantId 'TenantId' -ErrorSettings @{  
  ErrorMessageDetails = @{ 
    enabled = $True  
    url = "https://contoso.org/governanceMaterial" 
  } 
  ContactDetails= @{  
    enabled = $True 
    email = "admin@contoso.com" 
  } 
} 

Bloquer les commandes des licences d’essai

Commandes :

Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans

Les applets de commande de plans de consentement autorisés peuvent être utilisés pour ajouter ou supprimer l’accès à un type particulier de plan de consentement d’un client. Les plans de consentement « internes » sont soit des licences d’essai, soit des plans de communauté auxquels les utilisateurs peuvent s’inscrire via les portails Power Apps/Power Automate. Les plans de consentement « abonnement ad hoc » sont des licences d’essai auxquelles les utilisateurs peuvent s’inscrire via https://signup.microsoft.com ou les administrateurs peuvent attribuer aux utilisateurs via Azure Active Directory (Azure AD) ou le portail administrateur Microsoft 365. Par défaut, tous les types de plans de consentement sont autorisés chez un client. Un cas d’utilisation courant pour ces applets de commande est si un administrateur Power Platform souhaite empêcher les utilisateurs au sein de leur client de s’attribuer des licences d’évaluation, mais conserver la possibilité d’attribuer des licences d’évaluation au nom des utilisateurs. Cela peut être accompli en utilisant la commande Remove-AllowedConsentPlans -Types « Internal » ainsi que la désactivation du paramètre AllowAdHocSubscriptions dans Azure AD. Il est important de noter que lors de l’utilisation de Remove-AllowedConsentPlans tous les plans existants du type spécifié seront supprimés de tous les utilisateurs du client et ne seront pas récupérables. De plus, cela bloquera toute autre affectation de plans de ce type. Si, ultérieurement, l’administrateur Power Platform souhaite réactiver les offres de ce type, il peut utiliser Add-AllowedConsentPlans. S’il veut voir l’état actuel des plans de consentement autorisés, il peut utiliser Get-AllowedConsentPlans.

Des questions ?

Si vous avez des commentaires, des suggestions ou des questions, publiez-les sur Gestion du tableau de la communauté Power Apps.

Voir aussi

Commencer à utiliser le module d'administration Power Apps
Microsoft.PowerApps.Administration.PowerShell

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).