Prise en charge de PowerShell pour PowerApps (préversion)PowerShell support for PowerApps (preview)

Avec le lancement de la préversion des applets de commande PowerShell pour les administrateurs et les créateurs d’applications, vous pouvez automatiser de nombreuses tâches de monitoring et de gestion qui, actuellement, ne peuvent être utilisées que manuellement dans PowerApps ou le Centre d’administration PowerApps.With the preview launch of the PowerShell cmdlets for app creators and administrators, you can automate many of the monitoring and management tasks that are only possible manually today in PowerApps or the PowerApps Admin center.

InstallationInstallation

Pour exécuter des applets de commande PowerShell pour les créateurs d’applications, procédez comme suit :To run the PowerShell cmdlets for app creators, do the following:

  1. Téléchargez le fichier de scripts PowerShell.Download the PowerShell scripts file.

  2. Décompressez le fichier dans un dossier.Unzip the file into a folder.

  3. Ouvrez une fenêtre de commande PowerShell dans ce même dossier, en tant qu’administrateur.Open a PowerShell command window (as administrator) in that same folder.

  4. Exécutez la commande à usage unique PowerShell suivante (cela suppose que vous n’ayez jamais exécuté de commandes PowerShell sur l’ordinateur actuel) :Run the following one-time PowerShell command (this presumes you've never run PowerShell commands on the current machine):

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Force
    
  5. Importez les modules nécessaires à l’aide des commandes suivantes :Import the necessary modules using the following commands:

    Import-Module .\Microsoft.PowerApps.Administration.PowerShell.psm1 -Force
    Import-Module .\Microsoft.PowerApps.PowerShell.psm1 -Force
    
  6. Il existe un problème connu aujourd’hui qui peut également vous amener à débloquer manuellement les fichiers PowerShell à l’aide de la commande suivante :There is a known issue today that may also require you to manually unblock the PowerShell files using the following command:

    dir . | Unblock-File
    
  7. Avant d’accéder aux commandes, fournissez vos informations d’identification à l’aide de la commande suivante.Before accessing any of the commands, provide your credentials using the following command. Ces informations d’identification sont actualisées jusqu’à ~8 heures avant qu’il vous soit demandé de vous reconnecter pour continuer d’utiliser les applets de commande.These credentials are refreshed for up to ~8 hours before you're required to sign in again to continue using the cmdlets.

    Add-PowerAppsAccount
    

Applets de commande PowerApps pour les créateurs d’applications (préversion)PowerApps cmdlets for app creators (preview)

PrérequisPrerequisite

Les utilisateurs avec une licence PowerApps valide peuvent exécuter les opérations de ces applets de commande, mais ils n’auront accès qu’aux ressources (par exemple, les applications, les flux, etc.) qui ont été créées ou partagées avec eux.Users with a valid PowerApps license can perform the operations in these cmdlets, but they will only have access to the resources (for example, apps, flows, etc.) that have been created or shared with them.

Liste des applets de commandeCmdlet list

ObjectifPurpose Applet de commandeCmdlet
Lire les environnementsRead environments Get-PowerAppsEnvironmentGet-PowerAppsEnvironment
Get-FlowEnvironmentGet-FlowEnvironment
Lire, mettre à jour et supprimer une application de canevasRead, update, and delete a canvas app Get-AppGet-App
Remove-AppRemove-App
Publish-AppPublish-App
Set-AppDisplayNameSet-AppDisplayName
Get-AppVersionGet-AppVersion
Restore-AppVersionRestore-AppVersion
Lire, mettre à jour et supprimer les autorisations d’une application de canevasRead, update, and delete canvas app permissions Get-AppRoleAssignmentGet-AppRoleAssignment
Set-AppRoleAssignmentSet-AppRoleAssignment
Remove-AppRoleAssignmentRemove-AppRoleAssignment
Lire, mettre à jour et supprimer un fluxRead, update, and delete a flow Get-FlowGet-Flow
Get-FlowRunGet-FlowRun
Enable-FlowEnable-Flow
Disable-FlowDisable-Flow
Remove-FlowRemove-Flow
Lire, mettre à jour et supprimer les autorisations d’un fluxRead, update, and delete flow permissions Get-FlowOwnerRoleGet-FlowOwnerRole
Set-FlowOwnerRoleSet-FlowOwnerRole
Remove-FlowOwnerRoleRemove-FlowOwnerRole
Lire des approbations de flux et y répondreRead and respond to flow approvals Get-FlowApprovalRequestGet-FlowApprovalRequest
Get-FlowApprovalGet-FlowApproval
RespondTo-FlowApprovalRequestRespondTo-FlowApprovalRequest
Lire et supprimer des connexionsRead and delete connections Get-ConnectionGet-Connection
Remove-ConnectionRemove-Connection
Lire, mettre à jour et supprimer les autorisations de connexionRead, update, and delete connection permissions Get-ConnectionRoleAssignmentGet-ConnectionRoleAssignment
Set-ConnectionRoleAssignmentSet-ConnectionRoleAssignment
Remove-ConnectionRoleAssignmentRemove-ConnectionRoleAssignment
Lire et supprimer des connecteursRead and delete connectors Get-ConnectorGet-Connector
Remove-ConnectorRemove-Connector
Lire, mettre à jour et supprimer des autorisations de connecteur personnaliséesRead, update, and delete custom connector permissions Get-ConnectorRoleAssignmentGet-ConnectorRoleAssignment
Set-ConnectorRoleAssignmentSet-ConnectorRoleAssignment
Remove-ConnectorRoleAssignmentRemove-ConnectorRoleAssignment

Note

Utilisez les commandes suivantes pour comprendre la syntaxe et afficher des exemples pour chaque applet de commande :Use the following commands to understand syntax and view samples for each of the cmdlets:

Get-Help Get-PowerAppsEnvironment
Get-Help Get-PowerAppsEnvironment -Examples
Get-Help Get-PowerAppsEnvironment -Detailed

Applets de commande PowerApps pour les administrateurs (préversion)PowerApps cmdlets for administrators (preview)

PrérequisPrerequisite

Afin d’effectuer les opérations d’administration dans les applets de commande d’administration, vous aurez besoin de ce qui suit :To perform the administration operations in the admin cmdlets, you'll need the following:

Liste des applets de commandeCmdlet list

ObjectifPurpose Applets de commandeCmdlets
Lire et supprimer des environnementsRead and delete environments Get-AdminEnvironmentGet-AdminEnvironment
Remove-AdminEnvironmentRemove-AdminEnvironment
Lire, mettre à jour et supprimer les autorisations de l’environnementRead, update, and delete environment permissions

Ces applets de commande s’appliquent uniquement aux environnements qui n’ont pas une base de données Common Data Service (CDS) for Apps.These cmdlets only work for environments that do not have a Common Data Service (CDS) for Apps database.
Get-AdminEnvironmentRoleAssignmentGet-AdminEnvironmentRoleAssignment
Set-AdminEnvironmentRoleAssignmentSet-AdminEnvironmentRoleAssignment
Remove-AdminEnvironmentRoleAssignmentRemove-AdminEnvironmentRoleAssignment
Lire et supprimer des applications de canevasRead and remove canvas apps Get-AdminAppGet-AdminApp
Remove-AdminAppRemove-AdminApp
Lire, mettre à jour et supprimer les autorisations d’une application de canevasRead, update, and delete canvas app permissions Get-AdminAppRoleAssignmentGet-AdminAppRoleAssignment
Remove-AdminAppRoleAssignmentRemove-AdminAppRoleAssignment
Set-AdminAppRoleAssignmentSet-AdminAppRoleAssignment
Set-AdminAppOwnerSet-AdminAppOwner
Lire, mettre à jour et supprimer des fluxRead, update, and delete flows Get-AdminFlowGet-AdminFlow
Enable-AdminFlowEnable-AdminFlow
Disable-AdminFlowDisable-AdminFlow
Remove-AdminFlowRemove-AdminFlow
Remove-AdminFlowOwnerRoleRemove-AdminFlowOwnerRole
Lire et supprimer des connexionsRead and delete connections Get-AdminConnectionGet-AdminConnection
Remove-AdminConnectionRemove-AdminConnection
Lire, mettre à jour et supprimer les autorisations de connexionRead, update, and delete connection permissions Get-AdminConnectionRoleAssignmentGet-AdminConnectionRoleAssignment
Set-AdminConnectionRoleAssignmentSet-AdminConnectionRoleAssignment
Remove-AdminConnectionRoleAssignmentRemove-AdminConnectionRoleAssignment
Lire et supprimer des connecteurs personnalisésRead and delete custom connectors Get-AdminConnectorGet-AdminConnector
Remove-AdminConnectorRemove-AdminConnector
Lire, mettre à jour et supprimer des autorisations de connecteur personnaliséesRead, update, and delete custom connector permissions Get-AdminConnectorRoleAssignmentGet-AdminConnectorRoleAssignment
Set-AdminConnectorRoleAssignmentSet-AdminConnectorRoleAssignment
Remove-AdminConnectorRoleAssignmentRemove-AdminConnectorRoleAssignment
Lire les paramètres utilisateur PowerApps, les paramètres utilisateur-application et les notifications d’un utilisateurRead a user's PowerApps user settings, user-app settings, and notifications Get-AdminPowerAppsUserDetailsGet-AdminPowerAppsUserDetails
Lire et supprimer des paramètres Microsoft Flow d’un utilisateur qui ne sont pas visibles par l’utilisateur, mais qui prennent en charge l’exécution de fluxRead & delete a user's Microsoft Flow settings, which are not visible to user, but that support flow execution Get-AdminFlowUserDetailsGet-AdminFlowUserDetails
Remove-AdminFlowUserDetailsRemove-AdminFlowUserDetails
Créer, lire, mettre à jour et supprimer des stratégies de protection contre la perte de données pour votre organisationCreate, read, update & delete data loss prevention policies for your organization Get-AdminApiPolicyGet-AdminApiPolicy
Add-AdminApiPolicyAdd-AdminApiPolicy
Remove-AdminApiPolicyRemove-AdminApiPolicy
Set-AdminApiPolicySet-AdminApiPolicy
Add-ConnectorToBusinessDataGroupAdd-ConnectorToBusinessDataGroup
Remove-ConnectorFromBusinessDataGroupRemove-ConnectorFromBusinessDataGroup

Note

Utilisez les commandes suivantes pour comprendre la syntaxe et afficher un exemple pour chaque applet de commande :Use the following commands to understand syntax and view sample for each of the cmdlets:

Get-Help Get-AdminEnvironment
Get-Help Get-AdminEnvironment -Examples
Get-Help Get-AdminEnvironment -Detailed

Des questions ?Questions?

Si vous avez des commentaires, des suggestions ou des questions, envoyez-les au forum communautaire d’administration PowerApps.If you have any comments, suggestions, or questions, post them on the Administering PowerApps community board.