Jagamisviis:

PowerShelli tugi Power Apps ja Power Automate

Loojatele ja administraatoritele mõeldud PowerShell cmdlet-käskudega Power Platform saate automatiseerida paljusid jälgimis- ja haldustoiminguid. Ülesanded, mis on võimalikud ainult täna Power Apps, Power Automate või Power Platformi halduskeskuses.

cmdlet-käsud

Cmdlet-käsud on skriptikeeles PowerShell kirjutatud funktsioonid, mis täidavad PowerShell käske. Nende Power Apps cmdlet-käske käitades saate ärirakenduste platvormiga suhelda ilma veebibrauseris haldusportaali läbimata.

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.

Power Apps haldusmooduli kohta leiate teavet teemast Power Apps Microsoft.PowerApps.Administration.PowerShell 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

Selle artikli PowerShelli kasutamiseks on vaja Windows PowerShelli versiooni 5.x. Arvutis töötava PowerShelli versiooni kontrollimiseks käivitage järgmine käsk.

$PSVersionTable.PSVersion

Kui teil on aegunud versioon, avage Windge'i olemasolevate Windows PowerShelli.

Oluline

Selles dokumendis kirjeldatud moodulid kasutavad .NET raamistikku, mis ei ühildu PowerShell 6.0 ja uuemate versioonidega. Need uuemad 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.

    Kuvatõmmis, mis näitab, kuidas käivitada 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.

    Kuvatõmmis, mis näitab, kus aktsepteerida PowerShell installipoliitika väärtust.

  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äitada PowerShelli skripti, mis sihib mõnda keskkonda mittetulunduslikus piirkonnas (nt GCC), -Endpoint saab parameetriks määrata usgov GCC Moderate, usgovhigh GCC High või dod GCC DOD. 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 Apps cmdlet-käsud rakenduse loojate jaoks

Power Apps cmdlet-ide eeltingimused

Kehtiva Power Apps litsentsiga kasutajad saavad neid cmdlet-käske teha. 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 Microsoft Dataverse lahendusele 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 Apps cmdlet-käsud administraatoritele

Administraatorite cmdlet-käskude Power Apps ja Power Automate kohta leiate lisateavet teemast Windži platvormi administraatoritele mõeldud PowerShelli kasutamise alustamine.

Näpunäiteid

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

    Kuvatõmmis, mis näitab käsu Hangi abi kasutamist.

  • 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

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

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

Käsk Get-AdminEnvironment.

Power Apps käsud

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

Kõigi Power Apps loendi kuvamine

Get-AdminPowerApp

Tagastab kõigi rentniku Power Apps loendi koos iga (nt rakenduse nimi (GUID), kuvatava nime, looja ja palju muud) üksikasjadega.

Kõigi sisestuse kuvatavale nimele vastavate Power Apps loendi kuvamine

Get-AdminPowerApp 'DisplayName'

See käsk loetleb kõik teie rentniku Power Apps, 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'

Esiletõstetud rakendused rühmitatakse ja lükatakse Power Apps mobiilipleieris loendi algusse.

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

Pannoorakendus kuvatakse Power Apps mobiilipleieri loendi ülaservas. 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 omafunktsioonid Power Apps cmdlet-käskudega, et andmeid 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.

Käsk Get-AdminPowerApp.

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

Get-AdminPowerAppi keskkond.

Laadi alla Power Apps kasutaja üksikasjad

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

Eelmine käsk talletab Power Apps kasutaja üksikasjad (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 kõik teie rentniku määratud kasutajalitsentsid (Power Apps ja Power Automate) tabelivaatesse .csv faili. Eksporditud fail sisaldab nii iseteenindust, registreerumist, ettevõttesiseseid prooviversioone kui ka Microsoft Entra ID pärinevaid plaane. Sisemised prooviversioonilepingud pole Microsoft 365 halduskeskuse administraatoritele nähtavad.

Paljude Microsoft Power Platform kasutajatega rentnike eksportimine võib veidi aega võtta.

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 halduskeskust). Kasutajad, kellele olid Microsoft Entra ID määratud litsentsid (tavaliselt Microsoft 365 halduskeskuse kaudu), kuid 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. Taastatav kestus on 28 päeva. Ühtegi 28 päeva möödumisel kustutatud rakendust selles loendis ei tagastata ja neid ei saa taastada.

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.

SharePoint kohandatud vormikeskkonna määramine

Järgmisi cmdlet-käske saab kasutada vaikekeskkonna asemel selle määramiseks ja kontrollimiseks, millisesse keskkonda SharePoint kohandatud vormid salvestatakse. Kui SharePoint kohandatud vormide jaoks määratud keskkond muutub, salvestatakse selles keskkonnas vastloodud 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 praegu vastloodud SharePoint kohandatud vormide jaoks määratud keskkonna EnvironmentName. Kui keskkonda pole kunagi määratud, tagastatakse vaikekeskkond.

Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName'

See käsk määrab vaikekeskkonna asemel keskkonna, mis on vastloodud SharePoint kohandatud vormide salvestuskohta. Olemasolevad kohandatud vormid ei migreeru automaatselt äsja määratud keskkonda. Kohandatud vormide SharePoint saab määrata ainult tootmiskeskkonda.

Reset-AdminPowerAppSharepointFormEnvironment

See lähtestab vaikekeskkonna määratud keskkonnana SharePoint kohandatud vormide salvestamiseks.

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ätte väärtuseks on määratud true, saavad rakendusi ühiselt kasutada ainult administraatorirolliga kasutajad (Dynamics 365 administraator, Power Platform Service'i administraator Microsoft Entra rentnikuadministraator) ettevõttes Everyonega.

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

Ettevõtte juhtimise tõrketeate sisu Surface

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 leiate lisateavet teemast Mis Power Automate funktsioonid sisalduvad Power Apps litsentsides?

   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.

    Kuvatõmmis, mis näitab, et lõuendirakenduse AppName leiate lõuendirakenduse üksikasjade lehelt.

  • Mudelipõhise rakenduse AppName leiate lahenduseuurijast.

    Kuvatõmmis, mis näitab, et mudelipõhise rakenduse AppName on leitav 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".

käskude Power Automate

Nende oluliste käskude abil saate hallata Power Automate.

Administraatoritele mõeldud cmdlet-käskude Power Automate ja Power Apps täieliku loendi leiate teemast Hankige PowerShelli kasutamise alustamine Power Platformi administraatoritele.

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 jaotisest Microsoft Entra ID>ProfileObject ID. 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-toimingute abil.

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. Omaühendused leiate Dataverse>Connections vahekaardilt Power 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 Apps 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 rakenduse, mis on loodud Power Apps, mis ei ühildu andmepoliitikaga Üldiselt saadaval
2 Maker jagab Power Apps lõuendirakendust, kuid tal pole jagamise õigust Üldiselt saadaval
3 Maker jagab Power Apps lõuendirakendust EveryoneEveryone Üldiselt saadaval
4 Maker salvestab Power Apps abil loodud rakenduse, mis ei ühildu andmepoliitikaga Üldiselt saadaval
5 Maker salvestab Power Automate 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. Ettevõttesisesed nõusolekulepingud on kas prooviversiooni litsentsid või arendajalepingud, mille kasutaja saab ise registreeruda Power Apps/Power Automate portaalide/Power Automate töölauaversiooni kaudu. "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 Microsoft Entra ID või Microsoft 365 haldusportaali kaudu.

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äsuga Remove-AllowedConsentPlans -Types "Internal" ja mitte lubada Microsoft Entra ID sätet Update-MgPolicyAuthorizationPolicy -AllowedToSignUpEmailBasedSubscriptions.

Kui teil on küsimusi

Kui teil on kommentaare, soovitusi või küsimusi, postitage need Kogukonna tahvli haldamise Power Apps.

  • Last updated on