Compatibilidad con PowerShell para Power Apps

Artículo
05/25/2022
Tiempo de lectura: 18 minutos

Con los cmdlets de PowerShell para creadores y administradores de aplicaciones, puede automatizar muchas de las tareas de supervisión y administración que solo son posibles hoy en día de forma manual en Power Apps.

Cmdlets

Cmdlets son funciones escritas en el lenguaje de script de PowerShell que ejecutan comandos en el entorno de Windows PowerShell. Ejecutar estos cmdlets de Power Apps permite que se interactúe con su plataforma de aplicaciones empresariales sin tener que pasar por el portal de administración en un explorador web. Puede combinar estos cmdlets con otras funciones de PowerShell para escribir scripts complejos que pueden optimizar su flujo de trabajo. Tenga en cuenta que puede seguir usando los cmdlets si no es administrador en el inquilino, pero se limitará a los recursos de su propiedad. Los cmdlets que empiezan con la palabra "Admin" están diseñados para ser usados por una cuenta de usuario administrativa.

Los cmdlets están disponibles en la galería de PowerShell como dos módulos independientes:

Para obtener información sobre el módulo de administración de Power Apps, consulte Empezar a usar el módulo de administración de Power Apps y Microsoft PowerApps.Administration.PowerShell.

Nota

En relación con compatibilidad de nivel 2 de Dynamics 365 Government Community Cloud (GCC):

El extremo predeterminado es "prod". Si un usuario desea ejecutar un script de PowerShell dirigido a un entorno GCC, el parámetro -Endpoint debe cambiarse a "usgov" para GCC Moderate, "usgovhigh" para GCC High, o "dod" para GCC DOD.

Add-PowerAppsAccount -Endpoint "usgov"

Requisitos

En este tema, PowerShell requiere la versión 5.x de PowerShell. Para comprobar la versión de PowerShell que se ejecuta en su máquina, ejecute el siguiente comando:

$PSVersionTable.PSVersion

Si tiene una versión obsoleta, consulte Actualizar la versión de Windows PowerShell existente.

Importante

Los módulos que se describen en este documento usan .NET Framework. Esto lo hace incompatible con PowerShell 6.0 y versiones posteriores, que usa .NET Core.

Instalación

Para ejecutar los cmdlets de PowerShell para creadores de la aplicación, haga lo siguiente:

Ejecute PowerShell como administrador.

Importe los componentes necesarios mediante los siguientes comandos:

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

Como alternativa, si no tiene derechos de administrador en su equipo, puede usar lo siguiente para usar estos módulos:

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

Si se le solicita aceptar el cambio al valor InstallationPolicy del repositorio, acepte [A] Sí a todos los módulos. Para ello, escriba "A" y presione Entrar para cada módulo.

Antes de acceder a cualquiera de los comandos, tiene la opción de proporcionar sus credenciales usando el comando siguiente. Estas credenciales se actualizan hasta unas 8 horas antes de que deba iniciar sesión de nuevo para continuar usando los cmdlets.

# 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

Cmdlets de Power Apps para creadores de aplicaciones

Requisito previo

Los usuarios con una licencia de Power Apps válida pueden realizar operaciones en estos cmdlets, pero solo tendrán acceso a los recursos (por ejemplo, las aplicaciones, los flujos, etc.). que se hayan creado o se han compartido con ellos.

Lista de cmdlet - Cmdlets de fabricante

Nota

Hemos actualizado algunos de los nombres de función de cmdlets en la última versión para agregar prefijos adecuados para evitar colisiones. Consulte la tabla de abajo para una visión general de lo que ha cambiado.

Finalidad	Cmdlet
Agregar una aplicación de lienzo a una solución Microsoft Dataverse	Set-PowerAppAsSolutionAware
Leer entornos	Get-PowerAppEnvironment (antes, Get-PowerAppsEnvironment) Get-FlowEnvironment
Leer, actualizar, y eliminar una aplicación de lienzo	Get-PowerApp (antes, Get-App) Remove-PowerApp (antes Remove-App) Publish-PowerApp (antes Publish-App) Set-AppDisplayName (antes Set-PowerAppDisplayName) Get-PowerAppVersion (antes Get-AppVersion) Restore-PowerAppEnvironment (antes Restore-AppVersion)
Leer, actualizar, y eliminar permisos de aplicación de lienzo	Get-AdminPowerAppRoleAssignment (antes Get-AppRoleAssignment) Remove-AdminPowerAppRoleAssignment (antes Remove-AppRoleAssignment)
Leer, actualizar, y eliminar un flujo	Get-AdminFlow Enable-AdminFlow Disable-AdminFlow Remove-AdminFlow
Leer, actualizar, y eliminar permisos de flujo	Get-AdminFlowOwnerRole Set-AdminFlowOwnerRole Remove-AdminFlowOwnerRole
Lea y responder a aprobaciones de flujo	Get-AdminFlowApprovalRequest Remove-AdminFlowApprovals
Leer y eliminar conexiones	Get-AdminPowerAppConnection (antes Get-Connection) Remove-AdminPowerAppConnection (antes Remove-Connection)
Leer, actualizar, y eliminar permisos de conexión	Get-AdminPowerAppConnectionRoleAssignment (antes Get-ConnectionRoleAssignment) Set-AdminPowerAppConnectionRoleAssignment (antes Set-ConnectionRoleAssignment) Remove-AdminPowerAppConnectionRoleAssignment (antes Remove-ConnectionRoleAssignment)
Leer y eliminar conectores	Get-AdminPowerAppConnector (antes Get-Connector) Remove-AdminPowerAppConnector (antes Remove-Connector)
Agregar, leer, actualizar y eliminar permisos de conector personalizado	Get-AdminPowerAppConnectorRoleAssignment (antes Get-ConnectorRoleAssignment) Get-PowerAppConnectorRoleAssignment (antes Set-ConnectorRoleAssignment) Remove-PowerAppConnectorRoleAssignment (antes Remove-ConnectorRoleAssignment)
Leer, agregar y eliminar patrones de URL de directivas	Get-PowerAppPolicyUrlPatterns New-PowerAppPolicyUrlPatterns Remove-PowerAppPolicyUrlPatterns
Leer, registrar y quitar aplicaciones de administración	Get-PowerAppManagementApp Get-PowerAppManagementApps New-PowerAppManagementApp Remove-PowerAppManagementApp
Leer, crear, actualizar e importar claves de protección	Get-PowerAppRetrieveAvailableTenantProtectionKeys Get-PowerAppGenerateProtectionKey Get-PowerAppRetrieveTenantProtectionKey New-PowerAppImportProtectionKey Set-PowerAppTenantProtectionKey

Cmdlets de Power Apps para administradores

Para obtener más información sobre cmdlets de Power Apps para administradores, consulte Introducción a PowerShell para administradores de Power Platform

Recomendaciones

Use Get-Help 'nombre_cmdlet' para obtener una lista de ejemplos.
Para recorrer las opciones posibles para etiquetas de entrada, haga clic en la tecla TAB después de escribir del carácter de guión (-), después del nombre de cmdlet.

Comandos de ejemplo:

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

Ejemplos de operaciones

A continuación encontrará algunos escenarios comunes que muestran cómo usar cmdlets Power Apps nuevos o existentes.

Comandos de entornos
Comandos Power Apps
Comandos Power Automate
Comandos de conexión API
Comandos de directiva de prevención de pérdida de datos (DLP)
Cmdlets de exención de recursos de DLP
Bloquear comandos de licencias de prueba

Comandos de entornos

Use estos comandos para obtener detalles y actualizar entornos en su inquilino.

Mostrar una lista de todos los entornos.

Get-AdminPowerAppEnvironment

Devuelve una lista de cada entorno en el inquilino, con detalles de cada uno (p. ej., nombre del entorno (guid), nombre para mostrar, ubicación, creador, etc.).

Mostrar detalles del entorno predeterminado

Get-AdminPowerAppEnvironment –Default

Devuelve los detalles únicamente para el entorno predeterminado del inquilino.

Muestra detalles de entorno específico

Get-AdminPowerAppEnvironment –EnvironmentName 'EnvironmentName'

Nota: El campo EnvironmentName es un identificador único, que es diferente de DisplayName (consulte los primeros y segundos campos en la salida en la imagen siguiente).

Comando Get-AdminEnvironment.

Comandos Power Apps

Estas operaciones se usan para leer y modificar datos de Power Apps del inquilino.

Mostrar una lista de todos los Power Apps

Get-AdminPowerApp

Devuelve una lista de todas las Power Apps en el inquilino, con detalles de cada uno (p. ej., nombre de la aplicación (guid), nombre para mostrar, ubicación, creador, etc.).

Mostrar una lista de todos los Power Apps que coinciden el nombre para mostrar de entrada

Get-AdminPowerApp 'DisplayName'

Devuelve una lista de todos los Power Apps en el inquilino que coincidan con el nombre para mostrar.

Nota: escriba entre comillas (") los valores de entradas que contengan espacios.

Caracterizar una aplicación

Set-AdminPowerAppAsFeatured –AppName 'AppName'

Las aplicaciones caracterizadas se agrupan y se extraen a la parte superior de la lista en el reproductor móvil de Power Apps.

Nota: Como los entornos, el campo AppName es un identificador único, que es diferente de DisplayName. Si desea realizar operaciones en función del nombre para mostrar, algunas funciones le permitirán usar la canalización (consulte la función siguiente).

Convertir una aplicación en una aplicación prominente mediante la canalización

Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero

Una aplicación prominente aparecerá en la parte superior de la lista del reproductor móvil de Power Apps. Solo puede haber una aplicación prominente.

La canalización (representada como el carácter ‘|’ entre dos cmdlets) toma la salida del primer cmdlet y la pasa como el valor de entrada del segundo, asumiendo que la función se ha programado para admitir la característica de canalización.

Nota: una aplicación ya debe ser una aplicación caracterizada antes de que cambie a prominente.

Mostrar el número de aplicaciones que cada usuario posee

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

Puede combinar las funciones de PowerShell nativas con los cmdlets Power Apps para manipular los datos incluso más. Aquí usamos la función Select para aislar el atributo Propietario (un objeto) del objeto Get-AdminApp. A continuación aislamos el nombre de objeto de propietario canalizando esa salida a otra función Select. Por último, al pasar la segunda salida de la función Select a la función Group se devuelve una tabla interesante que incluye un recuento del número de aplicaciones de cada propietario.

Comando Get-AdminPowerApp.

Mostrar el número de aplicaciones en cada entorno

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

Get-AdminPowerApp environment.

Descargar detalles de usuario de Power Apps

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

El comando anterior almacenará los detalles del usuario de Power Apps (información básica de uso sobre el usuario de entrada mediante su nombre principal de usuario) en el archivo de texto especificado. Creará un nuevo archivo si no hay ningún archivo existente con ese nombre, y sobrescribirá el archivo de texto si ya existe.

Exportar una lista de licencias de usuario asignadas

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

Exporta todas las licencias de usuario asignadas (Power Apps y Power Automate) en su inquilino en un archivo .csv de vista tabular. El archivo exportado contiene tanto planes de prueba internos de registro de autoservicio como planes que con origen en Azure Active Directory. Los planes de prueba internos no son visibles para los administradores en el centro de administración de Microsoft 365.

La exportación puede tardar bastante tiempo para los inquilinos con un gran número de usuarios de Microsoft Power Platform.

Nota

Los resultados del cmdlet Get-AdminPowerAppLicenses solo incluyen licencias para los usuarios que han accedido a los servicios e Power Platform (por ejemplo, el centro de administración de Power Apps, Power Automate o Power Platform). Usuarios que han tenido licencias asignadas en Azure AD (típicamente a través del centro de administración de Microsoft 365) pero nunca he accedido a los servicios de Power Platform no tendrán sus licencias incluidas en la salida .csv generada. Además, dado que los servicios de licencia de Power Platform licencias almacenan en caché las licencias, las actualizaciones realizadas a las asignaciones de licencias en Azure AD puede tardar hasta siete días en reflejarse en el resultado de los usuarios que no han accedido al servicio recientemente.

Establecer el usuario conectado como propietario de una aplicación de lienzo

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

Cambia el rol de propietario de una PowerApp al usuario actual, y reemplaza el propietario original como un tipo de rol "puede ver".

Nota: Los campos AppName y EnvironmentName son los identificadores únicos (guids), no los nombres para mostrar.

Mostrar una lista de aplicaciones de lienzo eliminadas en un entorno

Get-AdminDeletedPowerAppsList -EnvironmentName 'EnvironmentName'

Esto muestra todas las aplicaciones de lienzo que se eliminaron recientemente y que aún pueden recuperarse.

Recuperar una aplicación de lienzo eliminada

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

Esto recupera una aplicación de lienzo que se puede descubrir a través del cmdlet Get-AdminDeletedPowerAppsList. Cualquier aplicación de lienzo que no se muestre en Get-AdminDeletedPowerAppsList no es recuperable.

Entorno de formulario personalizado de SharePoint designado

Los siguientes cmdlets se pueden usar para especificar y verificar en qué entorno se guardan los formularios personalizados de SharePoint, en lugar de en el entorno predeterminado. Cuando el entorno designado para los formularios personalizados de SharePoint cambia, este es el entorno donde se guardan los formularios personalizados recién creados. Los formularios personalizados existentes no se migran automáticamente a diferentes entornos cuando se utilizan estos cmdlets. La capacidad de un usuario para crear un formulario personalizado en un entorno designado requiere que el usuario tenga el rol de Creador del entorno. A los usuarios se les puede otorgar el rol de Creador del entorno en el centro de administración Power Platform.

Tenga en cuenta que se puede eliminar cualquier entorno que no sea el predeterminado. Si el designado formulario personalizado de SharePoint designado se elimina, los formularios personalizados también se eliminarán.

Get-AdminPowerAppSharepointFormEnvironment

Esto devuelve el EnvironmentName para el entorno actualmente designado para formularios personalizados de SharePoint recién creados. Si nunca se ha designado un entorno, se devuelve al entorno predeterminado.

Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName'

Esto designa el entorno en el que se guardan los formularios personalizados de SharePoint recién creados, en lugar del entorno predeterminado. Los formularios personalizados existentes no se migran automáticamente al entorno recién designado. Solo se pueden designar entornos de producción para formularios personalizados de SharePoint.

Reset-AdminPowerAppSharepointFormEnvironment

Esto restablece el entorno predeterminado como el entorno designado para guardar los formularios personalizados de SharePoint.

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

Esta configuración controla si los usuarios con Environment Maker rol de seguridad pueden compartir aplicaciones de lienzo con Todos en una organización. Cuando la configuración se establece en 'verdadero', solo los usuarios con un rol de administrador (administrador de Dynamics 365, Administrador de servicios Power Platform, administrador de inquilinos de Azure AD) puede compartir aplicaciones con 'Todos en una organización'.

Tenga en cuenta que, independientemente de esta configuración de inquilino, los creadores de valor con el privilegio de compartir pueden compartir aplicaciones con grupos de seguridad de cualquier tamaño. Este control solo determina si se puede usar la abreviatura 'Todos' al compartir.

$settings = Get-TenantSettings 
$settings.powerPlatform.powerApps.disableShareWithEveryone = $True 
Set-TenantSettings -RequestBody $settings

Destaque el contenido del mensaje de error de gobernanza de su organización

Si especifica que el contenido del mensaje de error de gobernanza aparezca en los mensajes de error, se incluirá en el mensaje de error que se muestra cuando los fabricantes observan que no tienen permiso para compartir aplicaciones con 'Todos'. Ver Comandos de contenido del mensaje de error de gobernanza de PowerShell..

Comandos Power Automate

Use estos comandos para ver y modificar los datos relacionados con Power Automate.

Mostrar todos los flujos

Get-AdminFlow

Devuelve una lista de todos los flujos en el inquilino.

Mostrar detalles del rol del propietario del flujo

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

Devuelve los detalles del propietario del flujo especificado.

Nota: Como Entornos y PowerApps, FlowName es el identificador único (guid), que es diferente del nombre para mostrar del flujo.

Mostrar detalles del usuario del flujo

Get-AdminFlowUserDetails –UserId $Global:currentSession.userId

Devuelve los detalles de usuario relacionados con el uso del flujo. En este ejemplo usamos como entrada el id. de usuario del usuario que inició la sesión de PowerShell.

Quitar detalles del usuario del flujo

Remove-AdminFlowUserDetails –UserId 'UserId'

Elimina completamente los detalles sobre un usuario del flujo de la base de datos de Microsoft. Todos los flujos que posee el usuario de entrada deben eliminarse para poder purgar los detalles de usuario del flujo.

Nota: el campo UserId es el identificador de objeto del registro de Azure Active Directory del usuario, que se encuentra en Azure Portal, en Azure Active Directory > Usuarios > Perfil > .Id. de objeto. Debe ser un administrador para acceder a estos datos desde aquí.

Exportar todos los flujos a un archivo CSV

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

Exporta todos los flujos del inquilino en un archivo .csv de vista tabular

Comandos de conexión API

Vea y administrar las conexiones API de su inquilino.

Mostrar todas las conexiones nativas en el entorno predeterminado

Get-AdminPowerAppEnvironment -Default | Get-AdminPowerAppConnection

Muestra una lista de todas las conexiones API que tiene en el entorno predeterminado. Las conexiones nativas se encuentran en la pestaña Datos > Conexiones en el portal del creador.

Mostrar todos conectores personalizados en el inquilino

Get-AdminPowerAppConnector

Devuelve una lista de todos los detalles de conectores personalizados en el inquilino.

Comandos de directiva de prevención de pérdida de datos (DLP)

Nota

La capacidad para bloquear conectores mediante el uso de una clasificación de tres niveles —Empresariales, No empresariales y Bloqueados— además del soporte de la interfaz de usuario de la directiva DLP en el centro de administración de Power Platform, están actualmente en versión preliminar pública. Hay una nueva directiva de DLP compatible con PowerShell para la clasificación de directivas de tres niveles de DLP, que también está en versión preliminar pública. El soporte de directivas DLP heredadas para clasificación de dos niveles (Empresariales y No empresariales), junto con la interfaz de usuario del centro de administración y el soporte de PowerShell para la clasificación de dos niveles, actualmente están disponibles con carácter generar y seguirán estando disponibles en el futuro próximo. Más información: Documentación de conectores

Estos cmdlets controlan las directivas DLP en el inquilino.

Crear una directiva DLP

New-DlpPolicy

Crea una nueva directiva de DLP para el inquilino del administrador que inició sesión.

Recuperar una lista de objetos DLP

Get-DlpPolicy

Obtiene objetos de directiva para el inquilino del administrador que inició sesión.

Actualizar una directiva de DLP

Set-DlpPolicy

Actualiza detalles de la directiva, como el nombre para mostrar de la directiva.

Quitar una directiva

Remove-DlpPolicy

Elimina una directiva DLP.

Cmdlets de exención de recursos de DLP

Estos cmdlets le permiten aplicar una exención o anularla para un recurso específico de una política de DLP.

Recuperar la lista de recursos exentos existente para una directiva DLP

Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName

Crear una nueva lista de recursos exentos para una directiva DLP

New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources

Actualizar la lista de recursos exentos para una directiva DLP

Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources

Quitar la lista de recursos exentos para una directiva DLP

Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName

Para eximir un recurso de una directiva DLP, necesita la siguiente información:

Id. de inquilino (GUID)
Id. de directiva DLP (GUID)
Id. de recurso (termina con un GUID)
Tipo de recurso

Puede recuperar el identificador y el tipo de recurso mediante los cmdlets de PowerShell Get-PowerApp para aplicaciones y Get-Flow para flujos.

Ejemplo

Para eximir el flujo con identificador f239652e-dd38-4826-a1de-90a2aea584d9 y la aplicación con identificador 06002625-7154-4417-996e-21d7a60ad624 se pueden ejecutar los siguientes cmdlets:

1. PS D:\> $flow = Get-Flow -FlowName f239652e-dd38-4826-a1de-90a2aea584d9 
2. PS D:\> $app = Get-PowerApp -AppName 06002625-7154-4417-996e-21d7a60ad624 
3. PS D:\> $exemptFlow = [pscustomobject]@{ 
4. >>             id = $flow.Internal.id 
5. >>             type = $flow.Internal.type 
6. >>         } 
7. PS D:\> $exemptApp = [pscustomobject]@{ 
8. >>             id = $app.Internal.id 
9. >>             type = $app.Internal.type 
10. >>         } 
11. PS D:\> $exemptResources = [pscustomobject]@{ 
12. >>             exemptResources = @($exemptFlow, $exemptApp) 
13. >>         } 
14. PS D:\> New-PowerAppDlpPolicyExemptResources -TenantId b1c07da8-2ae2-47e7-91b8-d3418892f507 -PolicyName 65da474a-70aa-4a59-9ae1-65a2bebbf98a -NewDlpPolicyExemptResources $exemptResources 
15. 
16. exemptResources 
17. --------------- 
18. {@{id=/providers/Microsoft.ProcessSimple/environments/Default-b1c07da8-2ae2-47e7-91b8-d3418892f507/flows/f239652e-dd38-4826-a1de-90a2aea584d9; type=Microsoft.ProcessSimple/environments/flows}, @{id=/providers/Microsoft.PowerApps/apps/06002625-7154-4417-996e-21d7a60ad..

Experiencia de exención de DLP en los siguientes escenarios:

#	Escenario	Experiencia
1	El usuario inicia una aplicación que no es compatible con DLP pero está exenta de DLP.	El lanzamiento de la aplicación continúa con o sin aplicación de DLP.
2	El creador guarda una aplicación que no es compatible con DLP pero está exenta de DLP	Con o sin exención de DLP, el cumplimiento de DLP no bloquea la operación de guardado de la aplicación. La advertencia de incumplimiento de DLP se muestra independientemente de la exención de DLP.
3	El creador guarda un flujo que no es compatible con DLP pero está exenta de DLP	Con o sin exención de DLP, el cumplimiento de DLP no bloquea la operación de guardado del flujo. La advertencia de incumplimiento de DLP no aparecerá.

Comandos de contenido del mensaje de error de gobernanza

Los siguientes cmdlets se pueden utilizar para guiar a los usuarios finales al material de referencia de gobierno de su organización, incluido un vínculo a la documentación de gobierno y un contacto de gobierno, cuando los controles de gobierno lo soliciten. Por ejemplo, cuando se configura el contenido del mensaje de error de gobernanza, aparecerá en Mensajes de cumplimiento de la política de prevención de pérdida de datos de Power Apps.

Establecer contenido del mensaje de error de gobernanza

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

La URL y el correo electrónico del mensaje de error de gobernanza se pueden mostrar de forma independiente o conjunta. La presencia de cada valor en el mensaje de error de gobernanza se controla mediante el campo "habilitado".

El contenido de este mensaje de error de gobernanza aparece en las siguientes experiencias.

#	Experiencia	Disponibilidad
1	El usuario inicia una aplicación Power Apps que no cumple con DLP	Generalmente disponible
2	Maker comparte una aplicación de lienzo Power Apps pero no tiene privilegio de compartir	Generalmente disponible
3	Maker comparte una aplicación de lienzo Power Apps con 'Todos' pero no tiene el privilegio de compartir con 'Todos'	Disponible en general
4	Maker guarda una aplicación Power Apps que no cumple con DLP	Disponible en general
5	El creador guarda un flujo Power Automate que no cumple con DLP	Disponible en general

Mostrar contenido del mensaje de error de gobernanza

Get-PowerAppDlpErrorSettings -TenantId 'TenantId'

Actualizar el contenido del mensaje de error de gobernanza

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

Bloquear comandos de licencias de prueba

Comandos:

Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans

Los cmdlets de planes de consentimiento permitidos se pueden usar para agregar o eliminar el acceso a un tipo particular de plan de consentimiento de un inquilino. Los planes de consentimiento "internos" son licencias de prueba o planes de desarrollador en los que los usuarios pueden registrarse a través de portales Power Apps/Power Automate. Los planes de consentimiento "Suscripción ad-hoc" o "Viral" son licencias de prueba en las que los usuarios pueden registrarse a través de https://signup.microsoft.com o los administradores pueden asignar a los usuarios a través de Azure Active Directory (Azure AD) o el portal de administración de Microsoft 365.

De forma predeterminada, todos los tipos de planes de consentimiento están permitidos en un inquilino. Un caso de uso común para estos cmdlets es si un administrador de Power Platform quiere bloquear a los usuarios dentro de su inquilino de la capacidad de asignarse licencias de prueba, pero conservar la capacidad de asignar licencias de prueba en nombre de los usuarios. Esto se puede lograr mediante el comando Remove-AllowedConsentPlans -Types "Internal", así como deshabilitando la configuración AllowAdHocSubscriptions en Azure AD.

Es importante tener en cuenta que al usar Remove-allowedConsentPlans, todos los planes existentes del tipo especificado se eliminarán de todos los usuarios del inquilino y no se podrán recuperar. Además, bloqueará toda asignación subsiguiente adicional de planes de ese tipo. Si, en un momento posterior, el administrador de Power Platform desea volver a habilitar planes de ese tipo que puedan usar Add-allowedConsentPlans. Si desean ver el estado actual de los planes de consentimiento permitidos, pueden usar Get-allowConsentPlans.

¿Desea realizar alguna pregunta?

Si tiene comentarios, sugerencias o preguntas, envíelas a Administración del panel de la comunidad de Power Apps.

Vea también

Empezar a usar el módulo de administración de Power Apps
Microsoft.PowerApps.Administration.PowerShell
Vista previa: información general de programabilidad y extensibilidad

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).

Compatibilidad con PowerShell para Power Apps

¿Le ha resultado útil esta página?

Cmdlets

Requisitos

Instalación

Cmdlets de Power Apps para creadores de aplicaciones

Requisito previo

Lista de cmdlet - Cmdlets de fabricante

Cmdlets de Power Apps para administradores

Recomendaciones

Ejemplos de operaciones

Comandos de entornos

Mostrar una lista de todos los entornos.

Mostrar detalles del entorno predeterminado

Muestra detalles de entorno específico

Comandos Power Apps

Mostrar una lista de todos los Power Apps

Mostrar una lista de todos los Power Apps que coinciden el nombre para mostrar de entrada

Caracterizar una aplicación

Convertir una aplicación en una aplicación prominente mediante la canalización

Mostrar el número de aplicaciones que cada usuario posee

Mostrar el número de aplicaciones en cada entorno

Descargar detalles de usuario de Power Apps

Exportar una lista de licencias de usuario asignadas

Establecer el usuario conectado como propietario de una aplicación de lienzo

Mostrar una lista de aplicaciones de lienzo eliminadas en un entorno

Recuperar una aplicación de lienzo eliminada

Entorno de formulario personalizado de SharePoint designado

Mostrar configuración de inquilino para la capacidad de compartir aplicaciones con 'Todos'

Cambiar configuración de inquilino para la capacidad de compartir aplicaciones con 'Todos'

Destaque el contenido del mensaje de error de gobernanza de su organización

Comandos Power Automate

Mostrar todos los flujos

Mostrar detalles del rol del propietario del flujo

Mostrar detalles del usuario del flujo

Quitar detalles del usuario del flujo

Exportar todos los flujos a un archivo CSV

Comandos de conexión API

Mostrar todas las conexiones nativas en el entorno predeterminado

Mostrar todos conectores personalizados en el inquilino

Comandos de directiva de prevención de pérdida de datos (DLP)

Crear una directiva DLP

Recuperar una lista de objetos DLP

Actualizar una directiva de DLP

Quitar una directiva

Cmdlets de exención de recursos de DLP

Recuperar la lista de recursos exentos existente para una directiva DLP

Crear una nueva lista de recursos exentos para una directiva DLP

Actualizar la lista de recursos exentos para una directiva DLP

Quitar la lista de recursos exentos para una directiva DLP

Experiencia de exención de DLP en los siguientes escenarios:

Comandos de contenido del mensaje de error de gobernanza

Establecer contenido del mensaje de error de gobernanza

El contenido de este mensaje de error de gobernanza aparece en las siguientes experiencias.

Mostrar contenido del mensaje de error de gobernanza

Actualizar el contenido del mensaje de error de gobernanza

Bloquear comandos de licencias de prueba

¿Desea realizar alguna pregunta?

Vea también

Comentarios