Power Apps ja Power Automate PowerShell-tuki

Power Platformin luojien ja järjestelmänvalvojien PowerShellin cmdlet-komentojen avulla voidaan automatisoida monia seuranta- ja hallintatehtäviä. Tehtävät, jotka ovat mahdollisia vain manually nykyään Power Apps, Power Automate tai Power Platform -hallintakeskuksessa.

Cmdlet-komennot

Cmdlet-komennot ovat PowerShell-skriptikielellä kirjoitettuja funktioita, jotka suorittavat komentoja PowerShell. Suorittamalla näitä Power Apps cmdlet-komentoja voit käyttää yrityssovellusympäristöä ilman verkkoselaimen hallintaportaalia.

Monimutkaisia työnkulkua optimoivia komentosarjoja voidaan kirjoittaa yhdistämällä cmdlet-komentoja muihin PowerShell-funktioihin. Voit käyttää cmdlet-komentoja, vaikka et olisi vuokraajan järjestelmänvalvoja. Silloin niitä voi kuitenkin käyttää omistamissasi resursseissa. Järjestelmänvalvojatason käyttäjätilillä käytettävän cmdlet-komennon alussa on Admin.

Cmdlet-komennot ovat käytettävissä PowerShell-valikoimassa kahtena erillisenä moduuleina:

• Järjestelmänvalvoja
• Luoja

Lisätietoja Power Apps hallintamoduulista on kohdassa Nouda Power Apps hallintamoduulin ja Microsoft.PowerApps.Administration.PowerShell käyttöä.

Aloita PowerShellin käyttö

Jos PowerShell on sinulle uutta ja tarvitset ohjeita sen löytämiseen ja käynnistämiseen, siirry tänne: PowerShellin käytön aloittaminen. Jos tarvitset ohjeita PowerShellin tai cmdlet-komentojen käyttöön, siirry tänne: PowerShellin ohjejärjestelmä.

PowerShellin edellytykset

Tämän artikkelin PowerShell edellyttää Windows PowerShell versiota 5.x. Voit tarkistaa koneellasi suoritettavan PowerShellin version suorittamalla seuraavan komennon:

$PSVersionTable.PSVersion

Jos sinulla on vanhentunut versio, siirry kohtaan Upgrading existing Windows PowerShell.

Moduulin asennus ja kirjautuminen

Sovelluksen tekijöiden PowerShellin cmdlet-komentojen suorittaminen:

1. Suorita PowerShell järjestelmänvalvojana.

   

2. Tuo tarvittavat moduulit.

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

   Asentamiseen voidaan vaihtoehtoisesti käyttää -Scope CurrentUser-parametria, jos tietokoneen järjestelmänvalvojan oikeudet eivät ole käytettävissä.

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

3. Jos säilön InstallationPolicy-arvon muutos pyydetään hyväksymään, hyväksy [A] Yes kaikissa moduuleissa kirjoittamalla ensin A ja painamalla sitten Enter-näppäintä kunkin moduulin kohdalla.

   

4. Vaihtoehtoisesti, ennen komentojen käyttöä, voit antaa tunnistetietosi. Tunnistetiedot päivitetään enintään noin 8 tunnin ajan, jonka jälkeen on kirjauduttava uudelleen. Jos tunnistetietoja ei anneta ennen komennon suorittamista, näyttöön tulee tunnistetietojen kehote.

   # Opens a prompt to collect credentials (Microsoft Entra account and password).
   Add-PowerAppsAccount
   

   # Here is how you can pass in credentials (to avoid opening a prompt).
   $pass = ConvertTo-SecureString "password" -AsPlainText -Force
   Add-PowerAppsAccount -Username user@contoso.com -Password $pass
   

5. Vaihtoehtoisesti voidaan kohdistaa tiettyyn päätepiste. Oletusarvoinen päätepiste on prod. Jos käyttäjä haluaa suorittaa PowerShell-komentosarjan, joka kohdistuu GCC:n tai muun kuin tuotantoalueen ympäristöön, -Endpoint parametriksi voidaan vaihtaa usgov joko GCC Moderate, usgovhigh GCC High tai dod GCC DOD. Täydellinen luettelo tuetuista päätetapahtumista on: "prod,esiversio,tip1,tip2,usgov,usgovhigh,dod,china".

   # An environment in another region, such as GCC, can be targeted using the -Endpoint parameter.
   Add-PowerAppsAccount -Endpoint "usgov" 
   

Moduulien päivitykset

Kaikkien PowerShell-moduulien versio voidaan tarkistaa käyttämällä komentoa Get-Module.

Get-Module

Kaikki PowerShell-moduulit voidaan päivittää uusimpaan versioon komennolla Update-Module.

Update-Module

Power Platform -moduulien versio voidaan puolestaan tarkistaa komennolla Get-Module ja -Name-parametrilla.

Get-Module -Name "Microsoft.PowerApps.Administration.PowerShell"
Get-Module -Name "Microsoft.PowerApps.PowerShell"

Power Platformin PowerShell-moduulit päivitetään käyttämällä komentoa Update-Module ja -Name-parametria.

Update-Module -Name "Microsoft.PowerApps.Administration.PowerShell"
Update-Module -Name "Microsoft.PowerApps.PowerShell"

Power Apps cmdlet-komennot sovellusten luojille

Power Apps cmdlet-komentojen edellytykset

Käyttäjät, joilla on kelvollinen Power Apps käyttöoikeus, voivat suorittaa näiden cmdlet-komentojen toimintoja. He voivat kuitenkin käyttää vain sellaisia resursseja, kuten sovelluksia ja työnkulkuja, jotka on luotu tai jaettu heidän kanssaan.

Cmdlet-luettelo – tekijän Cmdlet-komennot

Power Apps cmdlet-komentoja järjestelmänvalvojille

Lisätietoja järjestelmänvalvojien Power Apps ja Power Automate cmdlet-komennoista on kohdassa Käynnistäminen PowerShellillä Power Platform -järjestelmänvalvojille.

Vihjeet

• Esimerkkiluettelo voidaan hakea käyttämällä komentoa Get-Help ja lisäämällä sen jälkeen komennon CmdletName.

  

• Ajatusviivan - kirjoittamisen jälkeen syötetunniste voidaan selata painamalla Tab-näppäintä. Sijoita tämä tunniste cmdlet-komennon nimen jälkeen.

Esimerkkikomentoja:

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

Toimintaesimerkkejä

Seuraavassa on joitakin yleisiä skenaarioita, joissa esitellään uusien ja olemassa olevien Power Apps cmdlet-komentojen käyttöä.

• Ympäristöjen komennot
• Power Apps Commands
• Power Automate -komennot
• API-yhteyden komennot
• Tietokäytäntökomennot
• Tietoresurssin poikkeusten cmdlet-komennot
• Estä kokeiluversion käyttöoikeuksien komennot

Ympäristökomennot

Näillä komennoilla saadaan tietoja vuokraajan ympäristöistä ja voidaan päivittää niitä.

Kaikki ympäristöt sisältävän luettelon näyttäminen

Get-AdminPowerAppEnvironment

Palauttaa luettelon, joka sisältää jokaisen vuokraajan ympäristön sekä tietoja niistä (kuten ympäristön nimen (guid), näyttönimen, sijainnin ja tekijän).

Oletusympäristön tietojen näyttäminen

Get-AdminPowerAppEnvironment –Default

Palauttaa vain vuokraajan oletusympäristön tiedot.

Tietyn ympäristön tietojen näyttäminen

Get-AdminPowerAppEnvironment –EnvironmentName 'EnvironmentName'

Power Apps-komennot

Näillä toiminnoilla luetaan ja muokataan Power Apps tietoja vuokraajassa.

Kaikkien Power Apps luettelon näyttäminen

Get-AdminPowerApp

Palauttaa luettelon kaikista vuokraajan Power Apps ja tietoja kustakin (esimerkiksi sovelluksen nimi (GUID-tunnus), näyttönimi, tekijä ja paljon muuta).

Näytä luettelo kaikista Power Apps, jotka vastaavat syötteen näyttönimeä

Get-AdminPowerApp 'DisplayName'

Tässä komennossa luetellaan kaikki näyttönimeä vastaavat vuokraajan Power Apps.

Sovellukset esittelyssä

Set-AdminPowerAppAsFeatured –AppName 'AppName'

Esitellyt sovellukset ryhmitetään ja siirretään Power Apps mobiilisoittimen luettelon ylimmäksi.

Sovelluksen muuttaminen sankarisovellukseksi jakson avulla

Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero

Hero-sovellus näkyy Power Apps mobiilisoittimen luettelon yläreunassa. Sankarisovelluksia voi olla vain yksi.

Kahden cmdlet-komennon välissä oleva pystyviiva |siirtää ensimmäisen cmdlet-komennon tuloksen toisen komennon syötearvona, jos funktio kirjoitetaan hyväksymään pystyviiva.

Kunkin käyttäjän omistamien sovellusten määrän näyttäminen

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

Voit käsitellä tietoja vieläkin pidemmälle yhdistämällä PowerShell-alkuperäisfunktioita Power Apps cmdlet-komentoihin. Tässä esimerkissä Owner-määrite (objekti) eristetään Select-funktiolla Get-AdminApp-objektista. Seuraavaksi omistajan nimi eristetään jaksottamalla kyseinen tulos toiseen Select-funktioon. Kun toisen Select-funktion tuotos välitetään sitten Group-funktioon, tuloksena on taulukko, joka sisältää kunkin omistajan sovellusten määrän.

Kussakin ympäristössä olevien sovellusten määrän näyttäminen

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

Lataa Power Apps käyttäjätiedot

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

Edellinen komento tallentaa Power Apps käyttäjätiedot (peruskäyttötiedot käyttäjästä hänen päänimensä kautta) määritettyyn tekstitiedostoon. Komento luo uuden tiedoston, jos kyseisen nimistä tiedostoa ei ole luotu aiemmin, ja korvaa tekstitiedoston, jos sen on luotu jo aiemmin.

Määritettyjen käyttöoikeuksien luettelon vieminen

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

Vie vuokraajan kaikki määritetyt käyttöoikeudet (Power Apps ja Power Automate) taulukkonäkymätiedostoon .csv. Viety tiedosto sisältää sekä omatoimisen että rekisteröitymisen, sisäiset kokeilusuunnitelmat ja palvelupaketit, jotka on hankittu Microsoft Entra ID. Sisäiset kokeiluversiot eivät näy järjestelmänvalvojille Microsoft 365 hallintakeskuksessa.

Vienti voi kestää jonkin aikaa vuokraajille, joilla on suuri määrä Microsoft Power Platform käyttäjiä.

Kirjautuneen käyttäjän määrittäminen pohjaan perustuvan sovelluksen omistajaksi

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

Muuttaa Power App-merkin omistajaroolin nykyiseksi käyttäjäksi ja korvaa alkuperäisen omistajan "voi tarkastella" -roolityyppinä.

Poistettujen pohjaan perustuvien sovellusten luettelon näyttäminen ympäristössä

Get-AdminDeletedPowerAppsList -EnvironmentName 'EnvironmentName'

Tämä komento näyttää kaikki äskettäin poistetut pohjaan perustuvat sovellukset, sillä ne voivat olla edelleen palautettavissa. Palautettava kesto on 28 päivää. Mitään 28 päivän jälkeen poistettua sovellusta ei palauteta tähän luetteloon, eikä sitä voi palauttaa.

Poistetun kaaviosovelluksen palauttaminen

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

Tämä komento palauttaa pohjaan perustuva sovelluksen, joka on löydettävissä Get-AdminDeletedPowerAppsList-cmdlet-komennolla. Jos pohjaan perustuva sovellus ei näy Get-AdminDeletedPowerAppsList-luettelossa, sitä ei voi palauttaa.

Mukautetun lomakeympäristön SharePoint suunnittelu

Seuraavilla cmdlet-komennoilla voidaan määrittää ja tarkistaa, mihin ympäristöön SharePoint mukautetut lomakkeet tallennetaan oletusympäristön sijaan. Kun mukautettujen lomakkeiden SharePoint määritetty ympäristö muuttuu, juuri luotuja mukautettuja lomakkeita tallennetaan tähän ympäristöön. Aiemmin luotuja mukautettuja lomakkeita ei siirretä automaattisesti eri ympäristöihin, kun näitä cmdlet-komentoja käytetään. Käyttäjän mahdollisuus luoda mukautettu lomake määritetyssä ympäristössä edellyttää, että käyttäjällä on Ympäristön tekijä -rooli. Käyttäjille voidaan myöntää Ympäristön tekijä -rooli Power Platform -hallintakeskuksessa.

Mikä tahansa ympäristö, joka ei ole oletusympäristö, voidaan poistaa. Jos määritetty mukautetun lomakkeen SharePoint poistetaan, mukautetut lomakkeet poistetaan sen mukana.

Get-AdminPowerAppSharepointFormEnvironment  

Tämä komento palauttaa EnvironmentName ympäristölle, joka on tällä hetkellä määritetty juuri luoduille SharePoint mukautetuille lomakkeille. Jos ympäristöä ei ole koskaan määritetty, oletusympäristö palautetaan.

Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName' 

Tämä komento määrittää oletusympäristön sijasta ympäristön, SharePoint juuri luodut SharePoint mukautetut lomakkeet tallennetaan kohteeseen. Aiemmin luotuja mukautettuja lomakkeita ei siirretä automaattisesti juuri määritettyyn ympäristöön. Vain tuotantoympäristö voidaan nimetä mukautettujen lomakkeiden SharePoint.

Reset-AdminPowerAppSharepointFormEnvironment  

Tämä nollaa oletusympäristön määritettynä ympäristönä mukautettujen SharePoint lomakkeiden tallentamiseksi.

Vuokraajan asetuksen näyttäminen sovellusten Kaikki-jakamisoikeudella

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

Tämä asetus määrittää, voivatko ympäristön tekijän käyttöoikeusroolin omaavat käyttäjät jakaa pohjaan perustuvat sovellukset kaikkien organisaation käyttäjien kanssa. Kun asetuksena on true, vain käyttäjät, joilla on järjestelmänvalvojan rooli (Dynamics 365 järjestelmänvalvoja, Power Platform Servicen järjestelmänvalvoja Microsoft Entra vuokraajan järjestelmänvalvoja), voivat jakaa sovelluksia Kattava organisaatiossa.

Tästä vuokraajan asetuksista riippumatta tekijät, joilla on jakamisoikeus, voivat jakaa sovelluksia minkä kokoisille käyttöoikeusryhmille tahansa. Tämä ohjausobjekti määrittää vain, voiko Kaikki-lyhennettä käyttää jakamisen yhteydessä.

Vuokraajan asetuksen muuttaminen siten, että sovellusten jako-oikeutena on Kaikki

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

organisaatiosi hallinnon virhesanoman sisällön Surface

Jos hallinnon virhesanoman sisältö määritetään näkymään virhesanomissa, sisältö sisällytetään virhesanomaan, joka näytetään tekijöille, jos heillä ei ole sovellusten Kaikki-jako-oikeutta. Katso PowerShellin hallinnon virhesanoman sisällön komennot.

Työnkulkujen liittäminen sovellukseen kontekstissa

Liitä työnkulkuja sovellukseen sovelluksen kontekstissa luodaksesi riippuvuuden sovelluksen ja työnkulkujen välille. Lisätietoja kontekstityönkuluista on artikkelissa Mikä Power Automate ominaisuudet sisältyvät Power Apps käyttöoikeuksiin?

   Add-AdminFlowPowerAppContext -EnvironmentName <String> -FlowName <String> -AppName <String> [-ApiVersion <String>] [<CommonParameters>]

EnvironmentName ja FlowName löytyvät työnkulun URL-osoitteesta:

• Muun kuin ratkaisutyönkulun URL-osoite näyttää seuraavanlaiselta:

  https://preview.flow.microsoft.com/manage/environments/839eace6-59ab-4243-97ec-a5b8fcc104e7/flows/6df8ec2d-3a2b-49ef-8e91-942b8be3202t/details
  

  environments/-kohdan jälkeinen GUID-tunnus on EnvironmentName ja flows/-kohdan jälkeinen GUID-tunnus on FlowName

• Ratkaisutyönkulun URL-osoite näyttää seuraavanlaiselta:

  https://us.flow.microsoft.com/manage/environments/66495a1d-e34e-e330-9baf-0be559e6900b/solutions/fd140aaf-4df4-11dd-bd17-0019b9312238/flows/53d829c4-a5db-4f9f-8ed8-4fb49da69ee1/details
  

  environments/-kohdan jälkeinen GUID-tunnus on EnvironmentName ja flows/-kohdan jälkeinen GUID-tunnus on FlowName

• Pohjaan perustuvan sovelluksen AppName on pohjaan perustuvan sovelluksen tietosivulla.

  

• Mallipohjaisen sovelluksen AppName on ratkaisunhallinnassa.

  

• Esimerkkejä voi tarkastella kirjoittamalla get-help Add-AdminFlowPowerAppContext -examples.

• Lisätietoja saadaan kirjoittamalla get-help Add-AdminFlowPowerAppContext -detailed.

• Teknisiä tietoja saadaan kirjoittamalla get-help Add-AdminFlowPowerAppContext -full.

Sovelluksen kontekstissa olevien työnkulkujen poistaminen

Poista työnkulkujen ja sovelluksen välinen riippuvuus tällä PowerShell-komennolla. Remove-AdminFlowPowerAppContext poistaa sovelluksen kontekstin määritetyltä työnkululta.

    Remove-AdminFlowPowerAppContext -EnvironmentName <String> -FlowName <String> -AppName <String> [-ApiVersion <String>] [<CommonParameters>]

    - To see the examples, type: "get-help Remove-AdminFlowPowerAppContext -examples".
    - For more information, type: "get-help Remove-AdminFlowPowerAppContext -detailed".
    - For technical information, type: "get-help Remove-AdminFlowPowerAppContext -full".

Power Automate-komennot

Näiden tärkeiden komentojen avulla voit suorittaa Power Automate liittyvää hallintaa.

Täydellinen luettelo järjestelmänvalvojien Power Automate- ja Power Apps-cmdlet-komennoista on kohdassa Nouda käyttö PowerShellillä Power Platform -järjestelmänvalvojille.

Kaikkien työnkulkujen näyttäminen

Get-AdminFlow

Palauttaa luettelon kaikista vuokraajassa olevista työnkuluista.

Työnkulun omistajaroolin tietojen näyttäminen

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

Palauttaa määritetyn työnkulun omistajan tiedot.

Työnkulun käyttäjän tietojen näyttäminen

Get-AdminFlowUserDetails –UserId $Global:currentSession.userId

Palauttaa käyttäjän työnkulun käyttöä koskevat tiedot. Tässä esimerkissä käytetään syötteenä PowerShell-istunnon kirjautuneena olevan käyttäjän käyttäjätunnusta.

Työnkulun käyttäjän tietojen poistaminen

Remove-AdminFlowUserDetails –UserId 'UserId'

Poistaa työnkulun käyttäjän tiedot kokoisuudessaan Microsoft-tietokannasta. Kaikki syöttävän käyttäjän omistamat työnkulut on poistettava, ennen kuin työnkulun käyttäjän tiedot voidaan tyhjentää.

Kaikkien työnkulkujen vieminen CSV-tiedostoon

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

Kaikki vuokraajassa olevat työnkulut viedään taulukkomuotoiseen .csv-tiedostoon.

Työnkulkujen lisääminen Dataverse-ratkaisuihin

Add-AdminFlowsToSolution -EnvironmentName <String>

Ympäristön kaikkien muiden kuin ratkaisutyönkulkujen siirtäminen.

Parametrimuunnelmia voidaan käyttää siirtämään vain tiettyjä työnkulkuja, lisäämiseen tiettyyn ratkaisuun tai vain tietyn työnkulkumäärän siirtämiseen kerralla.

Teknisiä tietoja on kohdassa Add-AdminFlowsToSolution.

HTTP-toimintotyönkulkujen luettelo

Get-AdminFlowWithHttpAction -EnvironmentName <String>

Näyttää luettelon työnkuluista, joissa on HTTP-toimintoja.

API-yhteyden komennot

Ohjelmointirajapintayhteyksien tarkastelu ja hallinta vuokraajassa.

Kaikkien alkuperäisten yhteyksien näyttäminen oletusympäristössä

Get-AdminPowerAppEnvironment -Default | Get-AdminPowerAppConnection

Näyttää luettelon kaikista oletusympäristössä olevista ohjelmointirajapintayhteyksistä. Alkuperäiset yhteydet löytyvät Dataverse>Connections -välilehdestä Power Apps.

Kaikkien vuokraajassa olevien mukautettujen yhdistimien näyttäminen

Get-AdminPowerAppConnector

Palauttaa luettelon kaikista vuokraajassa olevien yhdistimien tiedoista.

Tietokäytäntökomennot

Näillä cmdlet-komennoilla hallitaan vuokraajasi tietokäytäntöjä.

Tietokäytännön luominen

New-DlpPolicy

Luo uuden tietokäytännön kirjautuneen järjestelmänvalvojan vuokraajaa varten.

Tietokäytäntöobjektien luettelon noutaminen

Get-DlpPolicy

Hakee käytännön objektit sisäänkirjautuneelle järjestelmänvalvojan vuokraajalle.

Tietokäytännön päivittäminen

Set-DlpPolicy

Päivittää käytännön tiedot, kuten käytännön näyttönimen.

Käytännön poistaminen

Remove-DlpPolicy

Poistaa tietokäytännön.

Tietoresurssin poikkeusten cmdlet-komennot

Näiden cmdlet-komentojen avulla voit vapauttaa tietyn resurssin käytännöstä tai poistaa sen.

Nouda aiemmin luotu poikkeusten sisältävä resurssiluettelo tietokäytännölle

Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Uuden poikkeustetun resurssiluettelon luominen tietokäytännölle

New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources 

Päivitä tietokäytännön poikkeusta sisältävä resurssiluettelo

Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources 

Poista tietokäytännön poikkeusten sisältävä resurssiluettelo

Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Jos haluat vapauttaa resurssin tietokäytännöstä, tarvitset seuraavat tiedot:

• Vuokraajan tunnus (GUID)
• Tietokäytännön tunnus (GUID)
• Resurssitunnus (päättyy GUID-tunnukseen)
• Resurssin tyyppi

Resurssitunnuksen voi noutaa käyttämällä sovellusten osalta PowerShell-cmdlet-komentoa Get-PowerApp ja työnkulkujen osalta komentoa Get-Flow.

Esimerkki poistokomentosarjasta

Suorittamalla seuraavat cmdlet-komennot muodostetaan poikkeus työnkululle, jonka tunnus on f239652e-dd38-4826-a1de-90a2aea584d9, ja sovellukselle, jonka tunnus on 06002625-7154-4417-996e-21d7a60ad624:

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 aaaabbbb-0000-cccc-1111-dddd2222eeee -PolicyName bbbbcccc-1111-dddd-2222-eeee3333ffff -NewDlpPolicyExemptResources $exemptResources 
15. 
16. exemptResources 
17. --------------- 
18. {@{id=/providers/Microsoft.ProcessSimple/environments/Default-aaaabbbb-0000-cccc-1111-dddd2222eeee/flows/f239652e-dd38-4826-a1de-90a2aea584d9; type=Microsoft.ProcessSimple/environments/flows}, @{id=/providers/Microsoft.PowerApps/apps/06002625-7154-4417-996e-21d7a60ad.. 

Tietokäytännön poikkeuskokemus seuraavissa skenaarioissa

Hallinnon virhesanoman sisällön komennot

Seuraavat cmdlet-komennot voivat johtaa loppukäyttäjät organisaation hallinnon viitemateriaaliin. Komento sisältää linkin hallinto-ohjeisiin ja hallinnon yhteystietoihin hallinto-ohjausobjektien niin kehottaessa. Kun esimerkiksi hallinnon virhesanoman sisältö määritetään, se näkyy Power Apps tietokäytännön suorituksenaikaiset pakotusviestit.

Hallinnon virhesanoman sisällön määrittäminen

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

Hallinnon virhesanoman URL-osoite ja sähköpostiviesti voidaan näyttää itsenäisesti tai yhdessä. Hallinnon virhesanoma voidaan ottaa käyttöön tai poistaa käytöstä enabled-kentän avulla.

Hallinnon virhesanoman sisältöskenaariot

Hallinnon virhesanoman sisällön näyttäminen

Get-PowerAppDlpErrorSettings -TenantId 'TenantId' 

Hallinnon virhesanoman sisällön päivittäminen

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

Tietokäytännön pakottaminen yhteyksien rikkomista varten – ympäristö

Näiden cmdlet-komentojen avulla voit pakottaa tietokäytännön, jos se rikkoo yhteyksiä ympäristön tai vuokraajan tasolla.

Pakota tietokäytännöt yhteyksien rikkomista varten

Voit valvoa tietokäytäntöjä ympäristössä. Pakottaminen poistaa käytöstä yhteydet, jotka rikkovat tietokäytäntöjä, ja mahdollistaa aiemmin käytöstä poistetut yhteydet, jotka eivät enää riko tietokäytäntöjä.

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName [Environment ID]

Esimerkki ympäristön käytön valvonnan komentosarjasta

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName c4a07cd6-cb14-e987-b5a2-a1dd61346963 

Tietokäytäntöjen pakottaminen yhteyksien rikkomista varten – vuokraaja

Voit ottaa käyttöön tietokäytäntöjä vuokraajan yhteyksissä. Pakottaminen poistaa käytöstä yhteydet, jotka rikkovat tietokäytäntöjä, ja mahdollistaa aiemmin käytöstä poistetut yhteydet, jotka eivät enää riko tietokäytäntöjä.

Start-DLPEnforcementOnConnectionsInTenant

Estä kokeiluversion käyttöoikeuksien komennot

Komennot:

Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans

Sallittujen suostumuksen palvelupakettien cmdlet-komennoilla voi lisätä tietyn tyyppisen suostumuksen palvelupaketin käyttöoikeuden tai poistaa sen vuokraajasta. Sisäiset suostumussuunnitelmat ovat joko kokeilukäyttöoikeuksia tai kehittäjäsuunnitelmia, joihin käyttäjät voivat rekisteröityä Power Apps/Power Automate portaalien/Power Automate kautta työpöydälle. Ad hoc -tilauksen tai viraalit hyväksymispalvelupaketit ovat kokeilukäyttöoikeuksia, joilla käyttäjät voivat rekisteröityä sivustossa https://signup.microsoft.com. Järjestelmänvalvojat voivat määrittää käyttäjiä Microsoft Entra ID tai Microsoft 365 hallintaportaalin kautta.

Oletusarvoisesti kaikentyyppiset suostumussopimukset sallitaan vuokraajassa. Power Platform -järjestelmänvalvoja saattaa kuitenkin haluta estää käyttäjiä määrittämästä itselleen kokeiluversion käyttöoikeuksia, mutta säilyttää mahdollisuuden määrittää kokeiluversion käyttöoikeuksia käyttäjien puolesta. Tämä sääntö voidaan suorittaa käyttämällä Remove-AllowedConsentPlans -Types "Internal" -komentoa, jolloin asetusta Update-MgPolicyAuthorizationPolicy -AllowedToSignUpEmailBasedSubscriptions ei sallita Microsoft Entra ID.

Jos sinulla on kysymyksiä

Jos sinulla on kommentteja, ehdotuksia tai kysymyksiä, julkaise ne Administering Power Apps yhteisötaulussa.

Liittyvät tiedot

• Hanki Power Apps admin module.
  
• Microsoft.PowerApps. Hallinto.PowerShell
  
• esiversio: Ohjelmoitavuuden ja laajennettavuuden yleiskatsaus