PowerShell tugi Power Apps ja Power Automate

Loojatele ja administraatoritele mõeldud PowerShell cmdlet-käskudega Power Platform saate automatiseerida paljusid jälgimis- ja haldustoiminguid. Toimingud, mis on praegu võimalikud ainult käsitsi halduskeskuses Power Apps või -keskuses Power Automate. Power Platform

cmdlet-käsud

Cmdlet-käsud on skriptikeeles PowerShell kirjutatud funktsioonid, mis täidavad PowerShell käske. Nende Power Apps cmdlet-käskude käitamine võimaldab teil suhelda oma ärirakenduste platvormiga, ilma et peaksite veebibrauseris haldusportaali läbima.

Saate cmdlet-käske kombineerida teiste PowerShell funktsioonidega, et kirjutada keerukaid skripte, mis võivad teie töövoogu optimeerida. Cmdlet-käske saate siiski kasutada, kui te pole rentniku administraator, kuid piirdute teile kuuluvate ressurssidega. Administratiivne kasutajakonto kasutab cmdlet-käske, mis algavad tähega Admin.

Cmdlet-käsud on saadaval PowerShelli galeriis kahe eraldi moodulina.

• Administraator
• Maker

Lisateavet Power Appsi administraatori mooduli kohta leiate teemast Power Appsi administraatori mooduli kasutamise alustamine ja Microsoft.PowerApps.Administration.PowerShell.

Alustage PowerShell kasutamist

Kui olete PowerShell uus kasutaja ja vajate abi selle leidmisel ja käivitamisel, minge lehele PowerShell kasutamise alustamine. Kui vajate PowerShell või cmdlet-käskude kasutamisel abi, avage abisüsteem PowerShell.

PowerShelli eeltingimused

PowerShell selles artiklis nõuab Windows PowerShell versiooni 5.x. Arvutis töötava PowerShelli versiooni kontrollimiseks käivitage järgmine käsk.

$PSVersionTable.PSVersion

Kui teil on aegunud versioon, minge olemasoleva Windows PowerShell täiendamine.

Oluline

Selles dokumendis kirjeldatud moodulid kasutavad .NET raamistik, mis ei ühildu PowerShell 6.0 ja uuemate versioonidega. Need hilisemad versioonid kasutavad .NET Core’i.

Mooduli paigaldamine ja sisselogimine

Rakenduse loojate jaoks PowerShell cmdlet-käskude käitamiseks tehke järgmist.

1. Käivitage PowerShell administraatorina.

   

2. Importige vajalikud moodulid.

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

   Teise võimalusena, kui teil pole arvutis administraatori õigusi, kasutage installimiseks parameetrit -Scope CurrentUser .

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

3. Kui teil palutakse aktsepteerida hoidla väärtuse Installipoliitika muudatus , nõustuge [A] Yes kõigi moodulitega, tippides A ja seejärel vajutage Enter iga mooduli jaoks.

   

4. Soovi korral saate enne käskudele juurdepääsu saamist sisestada oma mandaadi. Identimisteavet värskendatakse kuni kaheksa tundi, enne kui peate uuesti sisse logima. Kui mandaati ei anta enne käsu täitmist, kuvatakse mandaadiviip.

   # 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. Soovi korral saab sihtida konkreetset lõpp-punkti. Vaikimisi on tulemusnäitaja prod. Kui kasutaja soovib käivitada skripti PowerShell, mis on suunatud keskkonnale mittetootmispiirkonnas, näiteks GCC-le, -Endpoint saab parameetri muuta GCC mõõdukaks või usgov GCC DOD-i jaoks usgovhigh või GCC HighGCC DOD-i dod jaoks. Toetatud lõpp-punktide täielik loend on: "prod,eelversioon,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" 
   

Mooduli uuendused

Kõigi oma PowerShell moodulite versiooni saate kontrollida Get-Module abil.

Get-Module

Ja saate värskendada kõiki oma PowerShell mooduleid uusimatele, kasutades värskendusmoodulit.

Update-Module

Teise võimalusena kontrollige Power Platform moodulite versiooni, kasutades Get-Module’i ja parameetrit -Name .

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

Uuendage Power Platform PowerShell mooduleid, kasutades värskendusmoodulit ja parameetrit -Name .

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

Power Appsi cmdlet-käsud rakenduste loojatele

Power Appsi cmdlet-käskide eeltingimused

Kehtiva Power Apps litsentsiga kasutajad saavad teha toiminguid nendes cmdlet-käskudes. Kuid neil on juurdepääs ainult ressurssidele, nagu rakendused ja vood, mis on loodud või nendega jagatud.

Cmdlet-käskude loend – koostaja cmdlet-käsud

Märkus.

Värskendasime uusimas väljaandes mõningaid cmdlet-käsufunktsioonide nimesid, et lisada kokkupõrgete vältimiseks sobivad eesliited. Muutuse ülevaate leiate järgmisest tabelist.

Eesmärk	cmdlet-käsud
Lõuendirakenduse lisamine lahendusele Microsoft Dataverse	Set-PowerAppAsSolutionAware
Keskkondade lugemine ja värskendamine	Get-AdminPowerAppEnvironment(varem Get-PowerAppsEnvironment) Get-FlowEnvironment Restore-PowerAppEnvironment(varem Restore-AppVersion)
Rakenduse lõuend lugemine, värskendamine ja kustutamine	Get-AdminPowerApp(varem Get-App) Remove-AdminPowerApp(varem Remove-App) Publish-AdminPowerApp (varem Publish-App)
Rakenduse lõuend õiguste lugemine, värskendamine ja kustutamine	Get-AdminPowerAppRoleAssignment(varem Get-AppRoleAssignment) Remove-AdminPowerAppRoleAssignment(varem Remove-AppRoleAssignment)
Voo lugemine, värskendamine ja kustutamine	Get-AdminFlow Luba-AdminFlow Keela-AdminFlow Eemalda-AdminFlow
Voo õiguste lugemine, värskendamine ja kustutamine	Get-AdminFlowOwnerRole Set-AdminFlowOwnerRole Eemalda-AdminFlowOwnerRole
Voo kinnituste lugemine ja neile vastamine	Get-AdminFlowApprovalRequest Remove-AdminFlowApprovals
Ühenduste lugemine ja kustutamine	Get-AdminPowerAppConnection(varem Get-Connection) Remove-AdminPowerAppConnection(varem Remove-Connection)
Ühenduste õiguste lugemine, värskendamine ja kustutamine	Get-AdminPowerAppConnectionRoleAssignment(varem Get-ConnectionRoleAssignment) Set-AdminPowerAppConnectionRoleAssignment(varem Set-ConnectionRoleAssignment) Remove-AdminPowerAppConnectionRoleAssignment(varem Remove-ConnectionRoleAssignment)
Konnektorite lugemine ja kustutamine	Get-AdminPowerAppConnector(varem Get-Connector) Remove-AdminPowerAppConnector(varem Remove-Connector)
Kohandatud konnektori õiguste lisamine, lugemine, värskendamine ja kustutamine	Get-AdminPowerAppConnectorRoleAssignment(varem Get-ConnectorRoleAssignment) Get-PowerAppConnectorRoleAssignment(varem Set-ConnectorRoleAssignment) Remove-PowerAppConnectorRoleAssignment(varem Remove-ConnectorRoleAssignment)
Poliitika URL-i mustrite lugemine, lisamine ja eemaldamine	Get-PowerAppPolicyUrlPatterns New-PowerAppPolicyUrlPatterns Eemalda-PowerAppPolicyUrlPatterns
Haldusrakenduste lugemine, registreerimine ja eemaldamine	Get-PowerAppManagementApp Get-PowerAppManagementApps Uus PowerAppManagementApp Eemalda-PowerAppManagementApp
Kaitseklahvide lugemine, loomine, värskendamine ja importimine	Get-PowerAppRetrieveAvailableTenantProtectionKeys Get-PowerAppGenerateProtectionKey Get-PowerAppRetrieveTenantProtectionKey New-PowerAppImportProtectionKey Set-PowerAppTenantProtectionKey

Power Appsi cmdlet-käsud administraatoritele

Lisateavet Power Apps administraatoritele mõeldud cmdlet-käskude kohta Power Automate leiate teemast PowerShell kasutamise alustamine administraatoritele Power Platform .

Näpunäiteid

• Kasutage Get-Help näidete loendi saamiseks a-d, millele järgneb a CmdletName .

  

• Pärast mõttekriipsu - tippimist saate vajutada, et liikuda Tab läbi sisendsiltide. Asetage see lipp cmdleti nime järele.

Käskude näited:

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

Toimingu näited

Järgnevalt on toodud mõned levinumad stsenaariumid, mis näitavad, kuidas kasutada uusi ja olemasolevaid Power Apps cmdlet-käske.

• Keskkondade käsud
• Power Apps Käsud
• Power Automate Käsud
• API-ühenduse käsud
• Andmepoliitika käsud
• Andmeressursi vabastamise cmdlet-käsud
• Proovilitsentside blokeerimise käsud

Keskkondade käsud

Kasutage neid käske oma rentniku keskkondades üksikasjade leidmiseks ja värskendamiseks.

Kõikide keskkondade loendi kuvamine

Get-AdminPowerAppEnvironment

Tagastab rentniku iga keskkonna loendi koos iga keskkonna üksikasjadega (nt keskkonna nimi (guid), kuvatav nimi, asukoht, looja ja muu).

Vaike-keskkonna üksikasjade kuvamine

Get-AdminPowerAppEnvironment –Default

Tagastab ainult rentniku vaike-keskkonna üksikasjad.

Kindla keskkonna üksikasjade kuvamine

Get-AdminPowerAppEnvironment –EnvironmentName 'EnvironmentName'

Märkus.

Väli EnvironmentName on kordumatu identifikaator, mis erineb funktsioonist DisplayName (vt väljundi esimest ja teist välja järgmisel pildil).

Power Apps-i käsud

Neid toiminguid kasutatakse teie rentniku andmete lugemiseks ja muutmiseks Power Apps-is.

Saate kuvada kõige loendi Power Apps-is

Get-AdminPowerApp

Tagastab kõigi rentnike Power Apps loendi koos iga rentniku üksikasjadega (nt rakenduse nimi (guid), kuvatav nimi, looja ja muu).

Kuva kõigi Power Apps loend, mis vastavad sisestatud nimele

Get-AdminPowerApp 'DisplayName'

Selles käsus on loetletud kõik Power Apps teie rentniku liikmed, mis vastavad kuvatavale nimele.

Märkus.

Kasutage tühikuid sisaldavate sisendväärtuste ümber tsitaate. Näiteks kasutage "Minu rakenduse nimi".

Soovita rakendust

Set-AdminPowerAppAsFeatured –AppName 'AppName'

Soovitatavad rakendused on rühmitatakse ja lükatakse Power Apps-i mobiilimängija loendi algusesse.

Märkus.

Sarnaselt keskkondadega on väli AppName kordumatu identifikaator, mis erineb displayname’ist . Kui soovite toiminguid teha kuvatava nime põhjal, võimaldavad mõned funktsioonid teil kasutada konveierit (vt järgmine funktsioon).

Tehke rakendusest tunnusrakendus, kasutades konveierit

Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero

Mobiilipleieris kuvatakse loendi ülaosas Power Apps tunnusrakendus. Tunnusrakendusi võib olla ainult üks.

Kahe cmdleti vaheline torumärk | võtab esimese cmdleti väljundi ja edastab selle teise cmdleti sisendväärtusena, kui funktsioon on kirjutatud toru mahutamiseks.

Märkus.

Rakendus peab olema juba esiletõstetud rakendus, enne kui see pannooks muudetakse.

Kuvage rakenduste arv, mis iga kasutaja omab

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

Saate ühendada PowerShelli sisemisi funktsioone Power Apps cmdlet-käskudega, et andmeid saaks veelgi rohkem manipuleerida. Siin kasutame funktsiooni Vali, et isoleerida omaniku atribuut (objekt) Get-AdminApp objektist. Seejärel isoleerime omaniku objekti nime, suunates konteineri kaudu selle väljundi teise funktsiooni Vali. Lõpuks, teise funktsiooni Vali väljundi edastamine rühma funktsiooni, tagastab kena tabeli, mis sisaldab iga omaniku rakenduste arvu.

Kuvage rakenduste arv igas keskkonnas

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

Laadi alla Power Apps-i kasutaja üksikasjad

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

Eelmises käsus talletatakse Power Appsi kasutajaandmed (põhikasutusteave sisendkasutaja kohta kasutaja turvasubjektinime kaudu) määratud tekstifailis. See loob uue faili, kui selle nimega faili pole, ja kirjutab tekstifaili üle, kui see on juba olemas.

Määratud kasutajalitsentside loendi eksportimine

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

Ekspordib rentnikus kõik teie määratud kasutajalitsentsid (Power Apps ja Power Automate) tabelivaatesse .csv-faili. Eksporditud fail sisaldab nii iseteenindust, registreerumist, ettevõttesiseseid prooviversioonipakette kui ka ID-lt Microsoft Entra hangitud plaane. Sisemised proovilepingud pole adminustraatoritele Microsoft 365'i halduskeskuses nähtavad.

Suure hulga Microsoft Power Platformi kasutajatega rentnike puhul võib eksportimine võtta aega.

Märkus.

Get-AdminPowerAppLicenses cmdlet-käsu väljund sisaldab ainult litsentse kasutajatele, kes kasutavad Power Platformi teenuseid (nt Power Apps, Power Automate või Power Platformi halduskeskus). Kasutajad, kellele olid Microsoft Entra ID-ga määratud litsentsid (tavaliselt Microsoft 365 halduskeskuse kaudu), kuid kes pole kunagi Power Platformi teenustele juurde pääsenud, ei sisalda loodud .csv väljundis oma litsentse. Kuna Power Platformi litsentsiteenused salvestavad litsentsid vahemällu, võivad Microsoft Entra ID litsentsimääramiste värskendused võtta aega kuni seitse päeva, et kajastada nende kasutajate väljundit, kes ei pääsenud teenusele hiljuti juurde.

Sisselogitud kasutaja määramine lõuendrakenduse omanikuks

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

Muudab Power App omanikurolli praeguseks kasutajaks ja asendab algse omaniku rollitüübiga "saab vaadata".

Märkus.

Väljad AppName ja EnvironmentName on kordumatud identifikaatorid (guidid), mitte kuvatavad nimed.

Keskkonnas kustutatud lõuendrakenduste loendi kuvamine

Get-AdminDeletedPowerAppsList -EnvironmentName 'EnvironmentName'

See käsk kuvab kõik hiljuti kustutatud lõuendirakendused, kuna need võivad olla veel taastatud.

Kustutatud lõuendrakenduse taastamine

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

See käsk taastab cmdleti kaudu Get-AdminDeletedPowerAppsList leitava lõuendirakenduse. Mis tahes lõuendirakendust, mida jaotises ei kuvata Get-AdminDeletedPowerAppsList , ei saa taastada.

Kohandatud SharePoint vormikeskkonna määratlemine

Järgmisi cmdlet-käske saab kasutada, et määrata ja kontrollida, millisesse keskkonda kohandatud SharePoint vormid vaikekeskkonna asemel salvestatakse. Kui kohandatud vormidele SharePoint määratud keskkond muutub, salvestatakse see keskkond äsja loodud kohandatud vormid. Olemasolevad kohandatud vormid ei migreeru automaatselt erinevatesse keskkondadesse, kuna kasutatakse neid cmdlet-käske. Kasutaja võimalus luua kohandatud vorm määratud keskkonnas nõuab, et kasutajal oleks keskkonnas tegija roll. Kasutajatele saab anda keskkonna tegija rolli Power Platform halduskeskuses.

Kustutada saab mis tahes keskkonna, mis pole vaikekeskkond. Kui määratud SharePoint kohandatud vormikeskkond kustutatakse, kustutatakse kohandatud vormid koos sellega.

Get-AdminPowerAppSharepointFormEnvironment  

See käsk tagastab EnvironmentName keskkonna jaoks, mis on praegu määratud SharePoint vastloodud kohandatud vormidele. Kui keskkonda pole kunagi määratud, tagastatakse vaikekeskkond.

Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName' 

See käsk tähistab keskkonda, kuhu äsja loodud SharePoint kohandatud vormid salvestatakse, mitte vaikekeskkonda. Olemasolevad kohandatud vormid ei migreeru automaatselt äsja määratud keskkonda. Kohandatud vormidele SharePoint saab määrata ainult tootmiskeskkonda.

Reset-AdminPowerAppSharepointFormEnvironment  

See tähistab värskelt loodud SharePoint kohandatud vorme, mis salvestatakse vaikekeskkonna asemel.

Rentnikusätte kuvamine rakenduste kõigiga ühiskasutusse andmise võimaluse kohta

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

See säte määrab, kas keskkonna koostaja turberoll kasutajad saavad lõuendirakendusi ettevõtte kõigiga ühiskasutusse anda. Kui säte on seatud väärtusele tõene, saavad ainult administraatorirolliga (Dynamics 365 administraator, Power Platform teenuseadministraator, Microsoft Entra rentnikuadministraator) rakendusi kõigi ettevõtte töötajatega ühiskasutusse anda.

Sõltumata rentniku sätete väärtusest saavad jagamisõigusega koostajad jagada rakendusi igas suuruses turberühmadega. See juhtelement määrab ainult selle, kas jagamisel saab kasutada stenogrammi Kõik .

Rentnikusätte muutmine rakenduste kõigiga ühiskasutusse andmise võimaluse korral

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

Pange tähele oma asutuse tõrketeadete sisu

Kui määrate tõrketeadetes kuvatava korralduse tõrketeate sisu, kuvatakse tõrketeate sisu, kui tegijad märkavad, et neil pole õigust rakendusi kõigiga jagada. Vaadake PowerShelli edasijõudmise tõrketeate sisu käsud.

Kontekstivoogude seostamine rakendusega

Seostage rakenduse kontekstis olevad vood rakendusega, et luua rakenduse ja voogude vahel sõltuvus. Kontekstivoogude kohta lisateabe saamiseks vaadake teemat Millised Power Automate võimalused on Power Apps'i litsentsidesse kaasatud?

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

EnvironmentName ja FlowName on esitatud voo URL-is.

• Mittelahenduse voo puhul näeb URL välja selline:

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

  GUID pärast environments/ on Keskkonna nimi ja GUID pärast flows/ on FlowName

• Lahendusevoo URL näeb välja järgmine:

  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
  

  GUID pärast environments/ on Keskkonna nimi ja GUID pärast flows/ on FlowName

• Lõuendirakenduse AppName leiate lõuendirakenduse üksikasjade lehelt.

  

• Mudelipõhise rakenduse AppName leiate lahenduseuurijast.

  

• Näidete nägemiseks tippige: get-help Add-AdminFlowPowerAppContext -examples.

• Lisateabe saamiseks tippige: get-help Add-AdminFlowPowerAppContext -detailed.

• Tehnilise teabe saamiseks tippige: get-help Add-AdminFlowPowerAppContext -full

Eemaldage rakenduse kontekstis vood

Eemaldage selle PowerShelli käsuga voogude ja rakenduse vaheline sõltuvus. Remove-AdminFlowTextAppContext eemaldab rakenduse konteksti konkreetsest voost.

    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-i käsud

Kasutage neid olulisi käske seotud Power Automate administreerimiseks.

Administraatorite cmdlet-käskude Power Automate täieliku loendi ja Power Apps cmdlet-käskude leiate teemast Administraatoritele Power Platform mõeldud PowerShell kasutamise alustamine.

Kuva kõik vood

Get-AdminFlow

Tagastab kõigi rentniku voogude loendi.

Kuva voo omaniku rolli üksikasjad

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

Tagastab määratud voo omaniku üksikasjad.

Märkus.

Sarnaselt keskkondadega ja PowerApps, on ka FlowName kordumatu identifikaator (guid), mis erineb voo kuvatavast nimest.

Kuva voo kasutaja üksikasjad

Get-AdminFlowUserDetails –UserId $Global:currentSession.userId

Tagastab kasutaja andmed voo kasutamise kohta. Selles näites kasutame sisendina PowerShell seansi praeguse sisselogitud kasutaja ID-d.

Eemalda voo kasutaja üksikasjad

Remove-AdminFlowUserDetails –UserId 'UserId'

Kustutab andmevoo kasutaja andmed täielikult Microsofti andmebaasist. Kõik vood, mis on sisendi kasutajal, tuleb kustutada enne, kui voo kasutaja andmeid saab puhastada.

Märkus.

Väli UserId on kasutaja Microsoft Entra kirje objekti ID, mille leiate Azure portaalist ID kasutajaprofiili Microsoft Entra objekti ID> alt>>. Peate olema administraator, et siit andmetele juurde pääseda.

Ekspordi kõik vood CSV-faili

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

Ekspordib kõik oma rentniku vood tabelivaatena CSV-faili.

Voogude lisamine lahendustesse Dataverse

Add-AdminFlowsToSolution -EnvironmentName <String>

Migreerib kõik mittelahustuvad keskkonnavood.

Parameetrite variatsioone saab kasutada ainult kindlate voogude migreerimiseks, kindlasse lahendusse lisamiseks või ainult kindla arvu voogude migreerimiseks korraga.

Tehnilised üksikasjad leiate teemast Add-AdminFlowsToSolution.

HTTP-toiminguvoogude loetlemine

Get-AdminFlowWithHttpAction -EnvironmentName <String>

Loetleb vood HTTP-toimingutega.

Kuvatav nimi	Voo nimi	Keskkonna nimi
Hangi arve HTTP	flow-1	environment-1
Maksa arve rakendusest	flow-2	environment-2
Konto vastavusse ühildamine	flow-3	environment-3

API ühenduse käsud

Saate vaadata ja hallata oma rentniku API-ühendusi.

Kuva kõik kohalikud ühendused oma vaikekeskkonnas

Get-AdminPowerAppEnvironment -Default | Get-AdminPowerAppConnection

Kuvab kõigi API-ühenduste loendi, mis teil on vaikekeskkonnas. Kohalikke ühendusi leidub koostaja portaalis vahekaardil Dataverse>ÜhendusedPower Apps.

Kõigi kohandatud konnektorite kuvamine rentniku kaudu

Get-AdminPowerAppConnector

Tagastab kõigi kohandatud konnektorite üksikasjade loendi rentnikus.

Märkus.

Get-AdminPowerAppConnector ei loetleta lahenduses olevaid kohandatud konnektoreid. See on teadaolev argument.

Andmepoliitika käsud

Need cmdlet-käsud juhivad teie rentniku andmepoliitikaid.

Andmepoliitika loomine

New-DlpPolicy

Loob sisselogitud administraatori rentniku jaoks uue andmepoliitika.

Andmepoliitika objektide loendi toomine

Get-DlpPolicy

Toob poliitika objekte sisselogitud administraatori rentniku jaoks.

Märkus.

• PowerShelli abil andmepoliitika kuvamisel pärineb konnektorite kuvatav nimi sellest, millal andmepoliitika loodi või millal konnektorid poliitikas viimati teisaldati. Konnektorite kuvatavate nimede uued muudatused ei kajastu.
• PowerShelli abil andmepoliitika kuvamisel ei tagastata vaikerühma uusi konnektoreid, mida ei teisaldatud.

Mõlema teadaoleva probleemi puhul on lahenduseks teisaldada mõjutatud konnektor poliitikas teise rühma ja seejärel teisaldada see tagasi õigesse rühma. Pärast seda on kõik konnektorid nähtavad õige nimega.

Andmepoliitika värskendamine

Set-DlpPolicy

Värskendab poliitika üksikasju (nt poliitika kuvatavat nime).

Poliitika eemaldamine

Remove-DlpPolicy

Kustutab andmepoliitika.

Andmeressursi vabastamise cmdlet-käsud

Nende cmdlet-käskude abil saate teatud ressursi poliitikast vabastada või eemaldada.

Andmepoliitika jaoks olemasoleva välistatud ressursiloendi toomine

Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Andmepoliitika jaoks uue välistatud ressursiloendi loomine

New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources 

Andmepoliitika välistatud ressursiloendi värskendamine

Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources 

Andmepoliitika välistatud ressursiloendi eemaldamine

Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Ressursi andmepoliitikast vabastamiseks vajate järgmist teavet.

• Rentniku ID (JUHEND)
• Andmepoliitika ID (GUID)
• Ressursi ID (lõpeb JUHENDIGA)
• Ressursi tüüp

Ressursi ID ja tüübi saate hankida, kasutades rakenduste PowerShell cmdlet käske Get-PowerApp ja voogude jaoks Get-Flow.

Eemaldamise skripti näide

ID-ga f239652e-dd38-4826-a1de-90a2aea584d9 voo ja ID-ga 06002625-7154-4417-996e-21d7a60ad624 rakenduse eraldamiseks saame käitada järgmisi cmdlet-käske:

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.. 

Andmepoliitikast vabastamise kogemus järgmistes stsenaariumites

#	Stsenaarium	Kasutuskogemus
1	Kasutaja käivitab rakenduse, mis pole andmepoliitikaga ühilduv, kuid andmepoliitikast vabastatud.	Rakenduse käivitamine toimub andmepoliitika jõustamisega või ilma.
2	Maker salvestab rakenduse, mis ei ühildu andmepoliitikaga, kuid andmepoliitika on välistatud	Andmepoliitikast vabastamise korral või ilma selleta ei blokeeri andmepoliitika vastavus rakenduse salvestamist. Andmepoliitika mittevastavuse hoiatus kuvatakse sõltumata andmepoliitika erandist.
3	Maker salvestab voo, mis ei ühildu andmepoliitikaga, kuid andmepoliitika on välistatud	Andmepoliitikast vabastamise korral või ilma selleta ei blokeeri andmepoliitika vastavus voo salvestamist. Andmepoliitika mittevastavuse hoiatust ei kuvata.

Juhtimise veateate sisu käsud

Järgmised cmdlet-käsud võivad suunata teie lõppkasutajad teie organisatsiooni juhtimise juhendmaterjalide juurde. Käsk sisaldab linki juhtimisdokumentatsioonile ja juhtimiskontakti, kui juhtimiskontrollid seda nõuavad. Näiteks kui juhtimise tõrketeate sisu on määratud, kuvatakse see Power Appsi andmepoliitika käitusaja jõustamise teadetes.

Määra juhtimise veateate sisu

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

Juhtimise veateate URL-i ja e-posti aadressi saab näidata eraldi või koos. Saate väljaga enabled lubada või keelata valitsemise tõrketeate.

Korralduse tõrketeadete sisustsenaariumid

#	Stsenaarium	Kättesaadavus
1	Kasutaja käivitab Power Appsi abil loodud rakenduse, mis ei ühildu andmepoliitikaga	Üldiselt saadaval
2	Looja jagab Power Apps lõuendirakendust, kuid tal pole jagamisõigusi	Üldiselt saadaval
3	Maker jagab lõuendirakendust Power Apps kõigiga , kuid tal pole privileegi kõigiga jagada	Üldiselt saadaval
4	Maker salvestab Power Appsi abil loodud rakenduse, mis ei ühildu andmepoliitikaga	Üldiselt saadaval
5	Maker salvestab Power Automate'i voo, mis ei ühildu andmepoliitikaga	Üldiselt saadaval
6	Kasutaja käivitab keskkonnaga Dataverse seotud turberühma kuuluva rakenduse ilma turberühma kuulumiseta	Üldiselt saadaval

Kuva halduse veateate sisu

Get-PowerAppDlpErrorSettings -TenantId 'TenantId' 

Halduse veateate sisu värskendamine

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

Ühenduste rikkumise andmepoliitika jõustamine – keskkond

Need cmdlet-käsud võimaldavad teil jõustada andmepoliitika ühenduste rikkumiseks keskkonna või rentniku tasemel.

Ühenduste rikkumiseks andmepoliitikate jõustamine

Andmepoliitikaid saate jõustada keskkonna ühendustele. Jõustamine keelab olemasolevad ühendused, mis rikuvad andmepoliitikaid, ja lubab varem keelatud ühendused, mis ei riku enam andmepoliitikaid.

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName [Environment ID]

Keskkonna jõustamise skripti näide

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

Ühenduste rikkumise andmepoliitikate jõustamine – rentnik

Saate jõustada rentniku ühenduste andmepoliitikaid. Jõustamine keelab olemasolevad ühendused, mis rikuvad andmepoliitikaid, ja lubab varem keelatud ühendused, mis ei riku enam andmepoliitikaid.

Start-DLPEnforcementOnConnectionsInTenant

Blokeeri prooviversiooni litsentside käsud

Käsud:

Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans

Lubatud nõusolekulepingute cmdlet-käske saab kasutada rentniku teatud tüüpi nõusolekulepingutele juurdepääsu lisamiseks või eemaldamiseks. „Sisemised” nõusolekuplaanid on kas proovilitsentsid või arendusplaanid, mille jaoks kasutajad saavad end registreerida Power Apps'i/Power Automate'i portaalide/Power Automate'i töölauale. "Ad-hoc tellimus" või "viiruslik" nõusoleku plaanid on proovilitsentsid, mille kasutajaks https://signup.microsoft.com saavad kasutajad end registreerida. Administraatorid saavad kasutajaid määrata ID või Microsoft Entra haldusportaali kaudu Microsoft 365 .

Vaikimisi on kõik nõusolekulepingud rentnikus lubatud. Power Platformi administraator võib siiski soovida blokeerida kasutajatel enda prooviversioonilitsentside määramise, kuid säilitada võimaluse määrata kasutajate nimel prooviversioonilitsentse. Seda reeglit saab täita käsu abil Remove-AllowedConsentPlans -Types "Internal" ja mitte lubada Microsoft Entra ID-s sätte Update-MgPolicyAuthorizationPolicy -AllowedToSignUpEmailBasedSubscriptions .

Oluline

Kui kasutate , Remove-AllowedConsentPlanseemaldatakse kõik määratud tüüpi olemasolevad lepingud kõigilt rentniku kasutajatelt ja neid ei saa taastada. See käsk blokeerib kõik seda tüüpi tulevased ülesanded. Power Platform Kui administraator soovib seda tüüpi plaane uuesti lubada, saab ta neid kasutada Add-AllowedConsentPlans. Kui nad soovivad vaadata lubatud nõusolekuplaanide praegust olekut, saavad nad seda kasutada Get-AllowedConsentPlans.

Kui teil on küsimusi

Kui teil on kommentaare, soovitusi või küsimusi, postitage need Power Appsi haldamise kogukonna tahvlile.

Seotud teave

• Alustage haldusmooduli kasutamist Power Apps .
  
• Microsoft.PowerApps. Administratsioon.PowerShell
  
• eelversioon: Programmeeritavuse ja laiendatavuse ülevaade