Power Appsin ja Power Automaten PowerShell-tuki
Power Platformin luojien ja järjestelmänvalvojien PowerShellin cmdlet-komentojen avulla voidaan automatisoida monia seuranta- ja hallintatehtäviä. Kyse on tehtävistä, joita voidaan tehdä tällä hetkellä vain manuaalisestiPower Apps, Power AutomatessaPower Platform -toimintakeskuksessa.
Cmdlet-komennot
Cmdlet-komennot ovat PowerShellin komentosarjakielellä kirjoitettuja funktioita, jotka suorittavat komentoja PowerShellissä. Suorittamalla näitä Power Appsin cmdlet-komentoja voit olla vuorovaikutuksessa yrityssovellusympäristöön suoraan sen sijaan, että sinun pitäisi käyttää hallintaportaalia selaimessa.
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:
Power Appsin hallintamoduulin tiedot Power Apps -hallintamoduulin käytön aloittaminen ja Microsoft.PowerApps.Administration.PowerShell.
Muistiinpano
Dynamics 365 Government Community Cloud (GCC) -tason 2 tuki:
Oletuspäätepiste on prod. Jos käyttäjä haluaa suorittaa GCC-ympäristöön liittyvän PowerShell-komentosarjan, päätepisteparametri on muutettava muotoon usgov, jos kyseessä on GCC Moderate, muotoon usgovhigh, jos kyseessä on GCC High, tai muotoon dod, jos kyseessä on GCC DOD.
Add-PowerAppsAccount -Endpoint "usgov"
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ä.
edellytykset
Tämän artikkelin PowerShell vaatii Windows PowerShellin version 5.x. Voit tarkistaa koneellasi suoritettavan PowerShellin version suorittamalla seuraavan komennon:
$PSVersionTable.PSVersion
Jos sinulla on vanhentunut versio, siirry tänne: Olemassa olevan Windows PowerShellin päivittäminen.
Tärkeää
Tässä asiakirjassa kuvatuissa moduuleissa on käytössä .NET Framework, joka ei ole yhteensopiva PowerShell 6.0 ja sitä uudempien versioiden kanssa. Näissä uusissa versioissa on käytössä .NET Core.
Moduulien asennus
Sovelluksen tekijöiden PowerShellin cmdlet-komentojen suorittaminen:
Suorita PowerShell järjestelmänvalvojana.
Tuo tarvittavat moduulit.
Install-Module -Name Microsoft.PowerApps.Administration.PowerShell Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobberAsentamiseen 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 CurrentUserJos säilön InstallationPolicy-arvon muutos pyydetään hyväksymään, hyväksy
[A] Yeskaikissa moduuleissa kirjoittamalla ensinAja painamalla sittenEnter-näppäintä kunkin moduulin kohdalla.
Tunnistetiedot voidaan antaa seuraavalla komennolla ennen minkään komennon käyttämistä. Tunnistetiedot päivitetään enintään noin 8 tunnin ajan, jonka jälkeen on kirjauduttava uudelleen.
# 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
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"
Sovellusten luojien Power Appsin cmdlet-komennot
edellytykset
Käyttäjät, joilla on kelvollinen Power Apps -käyttöoikeus, voivat suorittaa toimintoja näillä cmdlet-komennoilla. 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
Muistiinpano
Jotkin cmdlet-funktioiden nimet on päivitetty uusimmassa julkaisussa lisäämällä soveltuvat etuliitteet. Tällä tavoin estetään ristiriidat. Seuraavassa taulukossa on yhteenveto tehdyistä muutoksista.
| Purpose | Cmdlet |
|---|---|
| Kaaviosovelluksen lisääminen Microsoft Dataverse -ratkaisuun | Set-PowerAppAsSolutionAware |
| Ympäristöjen luku ja päivitys | Get-AdminPowerAppEnvironment(aiemmin Get-PowerAppsEnvironment) Get-FlowEnvironment Restore-PowerAppEnvironment(aiemmin Restore-AppVersion) |
| Kaaviosovelluksen lukeminen, päivittäminen ja poistaminen | Get-AdminPowerApp(aiemmin Get-App) Remove-AdminPowerApp(aiemmin Remove-App) Publish-AdminPowerApp (aiemmin Publish-App) |
| Kaaviosovelluksen oikeuksien lukeminen, päivittäminen ja poistaminen | Get-AdminPowerAppRoleAssignment(aiemmin Get-AppRoleAssignment) Remove-AdminPowerAppRoleAssignment(aiemmin Remove-AppRoleAssignment) |
| Työnkulun lukeminen, päivittäminen ja poistaminen | Get-AdminFlow Enable-AdminFlow Disable-AdminFlow Remove-AdminFlow |
| Työnkulun oikeuksien lukeminen, päivittäminen ja poistaminen | Get-AdminFlowOwnerRole Set-AdminFlowOwnerRole Remove-AdminFlowOwnerRole |
| Työnkulun hyväksymisten lukeminen ja niihin vastaaminen | Get-AdminFlowApprovalRequest Remove-AdminFlowApprovals |
| Yhteyksien lukeminen ja poistaminen | Get-AdminPowerAppConnection(aiemmin Get-Connection) Remove-AdminPowerAppConnection(aiemmin Remove-Connection) |
| Yhteyden oikeuksien lukeminen, päivittäminen ja poistaminen | Get-AdminPowerAppConnectionRoleAssignment(aiemmin Get-ConnectionRoleAssignment) Set-AdminPowerAppConnectionRoleAssignment(aiemmin Set-ConnectionRoleAssignment) Remove-AdminPowerAppConnectionRoleAssignment(aiemmin Remove-ConnectionRoleAssignment) |
| Yhdistimien lukeminen ja poistaminen | Get-AdminPowerAppConnector(aiemmin Get-Connector) Remove-AdminPowerAppConnector(aiemmin Remove-Connector) |
| Mukautettujen yhdistimien käyttöoikeuksien lisääminen, lukeminen, päivittäminen ja poistaminen | Get-AdminPowerAppConnectorRoleAssignment(aiemmin Get-ConnectorRoleAssignment) Get-PowerAppConnectorRoleAssignment(aiemmin Set-ConnectorRoleAssignment) Remove-PowerAppConnectorRoleAssignment(aiemmin Remove-ConnectorRoleAssignment) |
| Käytännön URL-mallien lukeminen, lisääminen ja poistaminen | Get-PowerAppPolicyUrlPatterns New-PowerAppPolicyUrlPatterns Remove-PowerAppPolicyUrlPatterns |
| Hallintasovellusten lukeminen, rekisteröiminen ja poistaminen | Get-PowerAppManagementApp Get-PowerAppManagementApps New-PowerAppManagementApp Remove-PowerAppManagementApp |
| Luku-, luonti-, päivitys- ja tuontisuojausavaimet | Get-PowerAppRetrieveAvailableTenantProtectionKeys Get-PowerAppGenerateProtectionKey Get-PowerAppRetrieveTenantProtectionKey New-PowerAppImportProtectionKey Set-PowerAppTenantProtectionKey |
Järjestelmänvalvojien Power Appsin cmdlet-komennot
Lisätietoja järjestelmänvalvojien Power Appsin ja Power Automaten cmdlet-komennoista on kohdassa Power Platformin järjestelmänvalvojien PowerShellin käytön aloittaminen.
Vihjeet
Esimerkkiluettelo voidaan hakea käyttämällä komentoa
Get-Helpja lisäämällä sen jälkeen komennonCmdletName.
Ajatusviivan
-kirjoittamisen jälkeen syötetunniste voidaan selata painamallaTab-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ä
Seuraavaksi muutamassa yleisessä skenaariossa näytetään, miten uusia ja nykyisiä Power Appsin cmdlet-komentoja käytetään.
- Ympäristökomennot
- Power Apps-komennot
- Power Automate -komennot
- Ohjelmointirajapintayhteyden komennot
- Tietojen menetyksen estämiskäytännön DLP-komennot
- DLP-resurssipoikkeuksen cmdlet-komennot
- Kokeilukäyttöoikeuksien komentojen estäminen
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'
Muistiinpano
EnvironmentName-kenttä on yksilöivä tunnus, joka ei ole sama kuin DisplayName. (Katso tuloksen ensimmäinen ja toinen kenttä seuraavassa kuvassa.)
Power Apps-komennot
Näillä toiminnoilla voi lukea ja muokata Power Apps-tietoja vuokraajassa.
Kaikki Power Apps-sovellukset sisältävän luettelon näyttäminen
Get-AdminPowerApp
Palauttaa luettelon, joka sisältää kaikki vuokraajan Power Apps-sovellukset sekä tietoja niistä (kuten sovelluksen nimen (guid), näyttönimen ja tekijän).
Kaikki syötteen näyttönimeä vastaavat Power Apps-sovellukset sisältävän luettelon näyttäminen
Get-AdminPowerApp 'DisplayName'
Tämä komento muodostaa luettelon kaikista vuokraajan näyttönimeä vastaavista Power Apps-sovelluksista.
Muistiinpano
Välilyöntejä sisältävien syöttöarvojen ympärillä on käytettävä lainausmerkkejä. Esimerkki: "Oman sovelluksen nimi".
Sovellukset esittelyssä
Set-AdminPowerAppAsFeatured –AppName 'AppName'
Esittelyssä olevat sovellukset ryhmitellään ja siirretään ensimmäiseksi luettelossa Power Apps-mobiilitoistimessa.
Muistiinpano
Ympäristöjen tavoin AppName-kenttä on yksilöivä tunnus, joka ei ole sama kuin DisplayName. Jos haluat suorittaa näyttönimeen perustuvia toimintoja, jakson käyttö on mahdollista joissakin funktioissa. (Katso seuraava funktio.)
Sovelluksen muuttaminen sankarisovellukseksi jakson avulla
Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero
Sankarisovellus näkyy ensimmäisenä luettelossa Power Apps-mobiilitoistimessa. 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.
Muistiinpano
Sovelluksen on oltava esiin nostettu sovellus, ennen kuin se muutetaan sankarisovellukseksi.
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 monipuolisemmin yhdistämällä alkuperäiset PowerShell-funktiot ja Power Apps-cmdletit. 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 } }
Power Apps-käyttäjän tietojen lataaminen
Get-AdminPowerAppsUserDetails -OutputFilePath '.\adminUserDetails.txt' –UserPrincipalName 'admin@bappartners.onmicrosoft.com'
Edellä oleva komento tallentaa Power Apps-käyttäjän tiedot määritettyyn tekstitiedostoon. (Kyse on syöttävän käyttäjän peruskäyttötiedoista, jotka saadaan täydellisen käyttäjätunnuksen kautta.) 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 kaikki vuokralaiselle määritetyt käyttöoikeudet (Power Apps ja Power Automate) taulukkomuotoiseen .csv-tiedostoon. Viety tiedosto sisältää sekä itsepalvelun, kirjautumisen ja sisäiset kokeilusuunnitelmat että Microsoft Entra ID:stä peräisin olevat suunnitelmat. Sisäiset kokeilusuunnitelmat eivät näy Microsoft 365 -hallintakeskuksen järjestelmänvalvojille.
Vienti voi kestää jonkin aikaa niiden vuokraajien osalta, joilla on suuri määrä Microsoft Power Platform -käyttäjiä.
Muistiinpano
Get-AdminPowerAppLicenses-cmdlet-komennon tulos sisältää vain niiden käyttäjien käyttöoikeudet, jotka ovat käyttäneet Power Platform -palveluja (kuten Power Apps-, Power Automate- tai Power Platform -hallintakeskusta). Käyttäjien, joilla on ollut käyttöoikeus määritettynä Microsoft Entra ID:ssä (tavallisesti Microsoft 365 -hallintakeskuksen kautta), mutta jotka eivät ole koskaan käyttäneet Power Platform -palveluita, lisenssejä ei sisällytetä muodostettuun .csv-tulosteeseen. Ja koska Power Platformin käyttöoikeuspalvelimet tallentavat käyttöoikeudet välimuistiin, voi kestää jopa seitsemän päivää, ennen kuin käyttöoikeuksien määrityksiin Microsoft Entra ID:ssä tehdyt muutokset näkyvät tulosteessa niiden käyttäjien osalta, jotka eivät ole käyttänyt palvelua äskettäin.
Kirjautuneen käyttäjän määrittäminen pohjaan perustuvan sovelluksen omistajaksi
Set-AdminPowerAppOwner –AppName 'AppName' -AppOwner $Global:currentSession.userId –EnvironmentName 'EnvironmentName'
Muuttaa PowerApp-omistajan roolin nykyiselle käyttäjälle ja vaihtaa alkuperäiselle omistajalle katselutyyppisen roolin.
Muistiinpano
AppName- ja EnvironmentName-kentät ovat yksilöiviä tunnuksia (guid-tunnuksia) eivätkä näyttönimiä.
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.
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 SharePoint-lomakeympäristön määrittäminen
Seuraavien cmdlet-komentojen avulla voidaan määrittää ja tarkistaa, mihin SharePoint-ympäristön mukautetut lomakkeet tallennetaan oletusympäristön asemesta. Kun mukautettujen lomakkeiden määritetty SharePoint-ympäristö muuttuu, juuri luodut mukautetut lomakkeet tallennetaan kyseiseen 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 mukautetun lomakkeen määritetty SharePoint-ympäristö poistetaan, sen mukana poistetaan mukautetut lomakkeet.
Get-AdminPowerAppSharepointFormEnvironment
Tämä komento palauttaa juuri luotuihin mukautettuihin SharePoint-lomakkeisiin määritetyn ympäristön EnvironmentName-arvon. Jos ympäristöä ei ole koskaan määritetty, oletusympäristö palautetaan.
Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName'
Tämä komento määrittää oletusympäristön sijaan ympäristön, jonne uudet luodut mukautetut SharePoint-lomakkeet tallennetaan. Aiemmin luotuja mukautettuja lomakkeita ei siirretä automaattisesti juuri määritettyyn ympäristöön. Mukautetuille SharePoint-lomakkeille voidaan määrittää vain tuotantoympäristö.
Reset-AdminPowerAppSharepointFormEnvironment
Tämä palauttaa oletusympäristön määritetyksi ympäristöksi, johon mukautetut SharePoint-lomakkeet tallennetaan.
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 asetukseksi on määritetty tosi, vain käyttäjät, joilla on järjestelmänvalvojan rooli (Dynamics 365 -järjestelmänvalvoja, Power Platform -palvelun järjestelmänvalvoja, Microsoft Entra -vuokraajan järjestelmänvalvoja), voivat jakaa sovelluksia kaikkien organisaation käyttäjien kanssa.
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
Organisaation hallinnon virhesanoman sisällön näyttäminen
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 ohjeaiheessa Mitä Power Automate -ominaisuuksia sisältyy 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/detailsenvironments/-kohdan jälkeinen GUID-tunnus on EnvironmentName jaflows/-kohdan jälkeinen GUID-tunnus on FlowNameRatkaisutyö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/detailsenvironments/-kohdan jälkeinen GUID-tunnus on EnvironmentName jaflows/-kohdan jälkeinen GUID-tunnus on FlowNamePohjaan 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äillä tärkeillä komennoilla voidaan suorittaa Power Automateen liittyviä hallintatehtäviä.
Luettelo järjestelmänvalvojien kaikista Power Automate- ja Power Apps-cmdlet-komennoista on kohdassa Power Platform -järjestelmänvalvojien PowerShellin käytön aloittaminen.
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.
Muistiinpano
Ympäristöjen ja PowerAppsin tavoin FlowName on yksilöivä tunnus (guid), joka ei ole sama kuin työnkulun näyttönimi.
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ää.
Muistiinpano
UserId-kenttä on käyttäjän Microsoft Entra -tietueen objektin tunnus. Tämä tietue voidaan hakea valitsemalla Azure-portaalissaMicrosoft Entra ID>Käyttäjät>Profiili>Objektin tunnus. Vain järjestelmänvalvojat voivat käyttää tietoja täältä.
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.
Ohjelmointirajapintayhteyden 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 kohdan Dataverse>Yhteydet-välilehti kohdassa Power Apps.
Kaikkien vuokraajassa olevien mukautettujen yhdistimien näyttäminen
Get-AdminPowerAppConnector
Palauttaa luettelon kaikista vuokraajassa olevien yhdistimien tiedoista.
Muistiinpano
Get-AdminPowerAppConnector ei muodosta luetteloa ratkaisussa olevista mukautetuista yhdistimistä. Tämä on tunnettu rajoitus.
Tietojen menetyksen estämiskäytännön DLP-komennot
Näillä cmdlet-komennoilla voit määrittää vuokraajan DLP-käytännöt.
Luo DLP-käytäntö
New-DlpPolicy
Luo uuden DLP-käytännön sisäänkirjautuneelle järjestelmänvalvojan vuokraajalle.
DLP-objektien luettelon noutaminen
Get-DlpPolicy
Hakee käytännön objektit sisäänkirjautuneelle järjestelmänvalvojan vuokraajalle.
Muistiinpano
- Kun DLP-käytäntöä tarkastellaan PowerShellin avulla, yhdistimien näyttönimi saadaan DLP-käytännön luontihetkestä tai hetkestä, jolloin yhdistimiä viimeksi siirrettiin käytännön sisällä. Uusia yhdistimien näyttönimiä ei oteta huomioon.
- Kun DLP-käytäntöä tarkastellaan PowerShellin avulla, sellaisia oletusryhmän uusia yhdistimiä, joita ei ole siirretty, ei palauteta.
Nämä molemmat tunnetut ongelmat voi kiertää siirtämällä kulloisenkin yhdistimen toiseen käytäntöön kuuluvaan ryhmään ja siirtämällä sen takaisin oikeaan ryhmään. Kun tämä on tehty, jokainen yhdistin näkyy oikealla nimellä.
DLP-kä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 DLP-käytännön.
DLP-resurssipoikkeuksen cmdlet-komennot
Näiden cmdlet-komentojen avulla tietty resurssi voi muodostaa poikkeus DLP-käytännössä tai tämä poikkeus voidaan poistaa.
Aiemmin luodun DLP-käytännön resurssien poikkeusluettelon noutaminen
Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName
Uuden DLP-käytännön resurssien poikkeusluettelon luominen
New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources
DLP-käytännön resurssien poikkeusluettelon päivittäminen
Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources
DLP-käytännön resurssien poikkeusluettelon poistaminen
Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName
Resurssipoikkeuksen luomiseen DLP-käytännössä tarvitaan seuraavat tiedot:
- Vuokraajan tunnus (GUID)
- DLP-kä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 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..
DLP-poikkeuskokemus seuraavissa skenaarioissa
| # | Skenaario | Kokemus |
|---|---|---|
| 1 | Käyttäjä käynnistää sovelluksen, joka ei ole DLP-yhteensopiva, mutta siihen pätee DLP-poikkeus. | Sovelluksen käynnistys jatkuu DLP-pakotuksella tai ilman sitä. |
| 2 | Tekijä tallentaa sovelluksen, joka ei ole DLP-yhteensopiva, mutta siihen pätee DLP-poikkeus | DLP-poikkeuksesta riippumatta DLP-yhteensopivuus ei estä sovelluksen tallentamista. Varoitus DLP-yhteensopimattomuudesta näytetään DLP-poikkeuksesta riippumatta. |
| 3 | Tekijä tallentaa työnkulun, joka ei ole DLP-yhteensopiva, mutta siihen pätee DLP-poikkeus. | DLP-poikkeuksesta riippumatta DLP-yhteensopivuus ei estä työnkulun tallentamista. DLP-yhteensopimattomuudesta ei tule varoitusta. |
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. Jos hallinnon virhesanoman sisältöä on määritetty, se näkyy Power Appsin tietojen menetyksen estämisen käytännön suorituksen aikaisissa pakotussanomissa.
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
| # | Skenaario | Saatavuus |
|---|---|---|
| 1 | Käyttäjä käynnistää Power Appsilla luodun sovelluksen, joka ei ole DLP-yhteensopiva | Yleensä käytettävissä |
| 2 | Tekijä, jolla ei ole jako-oikeutta, jakaa Power Appsin kaaviopohjaisen sovelluksen | Yleensä käytettävissä |
| 3 | Tekijä, jolla ei ole Kaikki-jako-oikeutta, jakaa Power Appsin pohjaan perustuvan sovelluksen Kaikki-asetuksella | Yleensä käytettävissä |
| 4 | Tekijä tallentaa Power Appsilla luodun sovelluksen, joka ei ole DLP-yhteensopiva | Yleensä käytettävissä |
| 5 | Tekijä tallentaa Power Automate -työnkulun, joka ei ole DLP-yhteensopiva | Yleensä käytettävissä |
| 6 | Käyttäjä käynnistää sovelluksen kuulumatta Dataverse-ympäristölle määritettyyn käyttöoikeusryhmään | Yleensä käytettävissä |
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"
}
}
DLP-käytännön käytön pakottaminen sääntöjä rikkovissa yhteyksissä – ympäristö
Näiden cmdlet-komentojen avulla voit pakottaa DLP-käytäntöjen käyttämisen sääntöjä rikkovissa yhteyksissä ympäristön ja vuokraajan tasolla.
DLP-käytäntöjen käytön valvonta sääntörikkomusten osalta
DLP-käytäntöjen käyttöä voidaan valvoa ympäristön yhteyksissä. Käytön valvonta poistaa käytöstä aiemmin luodut yhteydet, jotka rikkovat DLP-käytäntöjä, ja ottaa käyttöön aiemmin käytöstä poistetut yhteydet, jotka eivät enää riko DLP-kä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
DLP-käytäntöjen käytön valvonta sääntörikkomusten osalta – vuokraaja
DLP-käytäntöjen käytön valvonta vuokraajan yhteyksissä. Käytön valvonta poistaa käytöstä aiemmin luodut yhteydet, jotka rikkovat DLP-käytäntöjä, ja ottaa käyttöön aiemmin käytöstä poistetut yhteydet, jotka eivät enää riko DLP-käytäntöjä.
Start-DLPEnforcementOnConnectionsInTenant
Kokeilukäyttöoikeuksien komentojen estäminen
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 hyväksymispalvelupaketit ovat joko kokeilukäyttöoikeuksia tai kehittäjien palvelupaketteja, joilla käyttäjät voivat rekisteröityä Power Apps- tai Power Automate -portaalin / Power Automate --työpöytäsovelluksen kautta. 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:n tai Microsoft 365 -hallintaportaalin kautta.
Oletusarvoisesti kaikkien suostumuksen palvelupakettityyppien käyttö on sallittu vuokraajassa. Power Platform -järjestelmänvalvoja saattaa kuitenkin ehkä haluta estää käyttäjiä määrittämistä itselleen kokeilukäyttöoikeuksia mutta säilyttää silti mahdollisuuden määrittää kokeilukäyttöoikeuksia käyttäjien puolesta. Tämä sääntö mahdollistetaan käyttämällä Remove-AllowedConsentPlans -Types "Internal"-komentoa ja poistamalla asetus AllowAdHocSubscriptions käytöstä Microsoft Entra ID:ssä.
Tärkeää
Kun Remove-AllowedConsentPlans on käytössä, kaikki nykyiset tietynlaiset palvelupaketit poistetaan vuokraajan kaikilta käyttäjiltä eikä niitä voi palauttaa. Tämä komento estää kaikki kyseisen tyypin määritykset tulevaisuudessa. Jos Power Platform -järjestelmänvalvoja haluaa myöhemmin ottaa käyttöön kyseisen tyyppisiä palvelupaketteja, se on mahdollista komennolla Add-AllowedConsentPlans. Sallittujen suostumuspakettien nykyistä tilaa voi tarkastella käyttämällä komentoa Get-AllowedConsentPlans.
Jos sinulla on kysymyksiä
Jos sinulla on kommentteja, ehdotuksia tai kysymyksiä, kirjoita ne Power Appsin hallintayhteisön palstalle.
Katso myös
Power Appsin järjestelmänvalvojan moduulin käytön aloittaminen.
Microsoft.PowerApps.Administration.PowerShell
Esiversio: Ohjelmoitavuuden ja laajennettavuuden yleiskatsaus