Bendrinti naudojant


PowerShell palaikymas Power Apps ir Power Automate

Naudodami PowerShell cmdlet Power Platform kūrėjams ir administratoriams galite automatizuoti daugelį stebėjimo ir valdymo užduočių. Užduotys, kurias šiandien galima atlikti tik rankiniu būdu arba Power AppsPower Automate administravimo centre. Power Platform

„Cmdlet“

Cmdlet yra funkcijos, parašytos PowerShell scenarijaus kalba, kurios vykdo komandas PowerShell. Vykdydami šias Power Apps cmdlet galite sąveikauti su verslo programų platforma nesilankydami administratoriaus portale žiniatinklio naršyklėje.

Galite derinti cmdlet su kitomis PowerShell funkcijomis, kad parašytumėte sudėtingus scenarijus, kurie gali optimizuoti jūsų darbo eigą. Vis tiek galite naudoti cmdlet, jei nesate nuomotojo administratorius, bet apsiribojate turimais ištekliais. Administruojančio vartotojo abonementas naudoja cmdlet, kurios prasideda Admin.

„Cmdlet“ „PowerShell“ galerijoje pasiekiami kaip du atskiri moduliai:

Informacijos apie „Power Apps“ administravimo modulį žr. Darbo su „Power Apps“ administravimo moduliu pradžia ir Microsoft.PowerApps.Administration.PowerShell.

Darbo su PowerShell pradžia

Jei esate naujokas PowerShell ir jums reikia pagalbos jį randant ir paleidžiant, eikite į Darbo su PowerShell pradžia. Jei reikia pagalbos naudojant PowerShell arba cmdlet, eikite į PowerShell pagalbos sistemą.

"PowerShell" būtinosios sąlygos

PowerShell šiame straipsnyje reikalinga "Windows" PowerShell versija 5.x. Norėdami patikrinti, jūsų įrenginyje įdiegtos „PowerShell“ versiją, vykdykite šią komandą:

$PSVersionTable.PSVersion

Jei turite pasenusią versiją, eikite į Esamos "Windows" versijos naujinimas PowerShell.

Svarbu

Šiame dokumente aprašyti moduliai naudoja .NET Framework, kuris nesuderinamas su PowerShell 6.0 ir naujesnėmis versijomis. Šios vėlesnės versijos naudoja ".NET Core".

Modulio diegimas ir prisijungimas

Norėdami paleisti PowerShell cmdlet programėlių kūrėjams:

  1. Paleiskite „PowerShell“ administratoriaus teisėmis.

    Ekrano kopija, kurioje rodoma, kaip paleisti PowerShell kaip administratorių.

  2. Importuokite reikiamus modulius.

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

    Arba, jei neturite kompiuterio administratoriaus teisių, naudokite diegimo parametrą -Scope CurrentUser .

    Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -Scope CurrentUser
    Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber -Scope CurrentUser
    
  3. Jei būsite paraginti priimti saugyklos reikšmės InstallPolicy pakeitimą, priimkite [A] Yes į visus modulius įvesdami A tekstą, tada paspauskite Enter kiekvieno modulio reikšmę.

    Ekrano kopija, kurioje rodoma, kur priimti PowerShell reikšmę InstallationPolicy.

  4. Pasirinktinai, prieš pasiekdami komandas, galite pateikti savo kredencialus. Kredencialai atnaujinami iki aštuonių valandų, kol vėl reikia prisijungti. Jei kredencialai nepateikiami prieš vykdant komandą, pasirodo kredencialų raginimas.

    # 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. Pasirinktinai galima taikyti pagal konkretų vertinamąjį tašką. Numatytasis galinis punktas yra prod. Jei vartotojas nori vykdyti scenarijų PowerShell, nukreiptą į aplinką ne gamybos regione, pvz., GCC, parametrą -Endpoint galima pakeisti į usgov GCC Moderate arba usgovhigh for GCC High arba dod GCC DOD. Visas palaikomų galinių taškų sąrašas yra: "prod,peržiūros versija,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" 
    

Modulio atnaujinimai

Galite patikrinti visų savo PowerShell modulių versiją naudodami Get-Module.

Get-Module

Taip pat galite atnaujinti visus savo PowerShell modulius į naujausius naudodami atnaujinimo modulį.

Update-Module

Arba patikrinkite Power Platform modulių versiją, naudodami Get-Module ir parametrą -Name .

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

Atnaujinkite Power Platform PowerShell modulius naudodami "Update-Module " ir parametrą -Name .

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

„Power Apps” „cmdlet”, skirtos programų kūrėjams

"Power Apps" cmdlet būtinosios sąlygos

Vartotojai, turintys galiojančią Power Apps licenciją, gali atlikti operacijas šiose cmdlet. Tačiau jie turi prieigą tik prie išteklių, pvz., programų ir srautų, kurie yra sukurti arba bendrinami su jais.

„Cmdlet“ sąrašas – kūrėjo „cmdlet“

Pastaba.

Naujausiame leidime atnaujinome kai kuriuos cmdlet funkcijų pavadinimus, kad įtrauktume atitinkamus priešdėlius, kad išvengtume susidūrimų. Norėdami peržiūrėti, kas pasikeitė, žr. toliau pateiktą lentelę.

Tikslas „Cmdlet“
Pridėti drobės programą prie „Microsoft Dataverse“ sprendimo Set-PowerAppAsSolutionAware
Nuskaityti ir naujinti aplinkas Get-AdminPowerAppEnvironment (anksčiau Get-PowerAppsEnvironment)
Get-FlowEnvironment
Atkurti-PowerAppEnvironment(anksčiau Atkurti-AppVersion)
Skaityti, naujinti ir naikinti drobės programą Get-AdminPowerApp(anksčiau Get-App)
"Remove-AdminPowerApp" (anksčiau "Remove-App")
Publish-AdminPowerApp (anksčiau Publish-App)
Skaityti, naujinti ir naikinti drobės programos teises Get-AdminPowerAppRoleAssignment(anksčiau Get-AppRoleAssignment)
Remove-AdminPowerAppRoleAssignment(anksčiau Remove-AppRoleAssignment)
Skaityti, naujinti ir naikinti srautą Get-AdminFlow
Įgalinti-AdminFlow
Išjungti-AdminFlow
Pašalinti-AdminFlow
Skaityti, naujinti ir naikinti srauto teises Get-AdminFlowOwnerRole
Set-AdminFlowOwnerRole
Pašalinti-AdminFlowOwnerRole
Skaityti ir atsakyti į srauto patvirtinimus Get-AdminFlowApprovalRequest
Pašalinti-AdminFlowPatvirtinimai
Skaityti ir naikinti srautus Get-AdminPowerAppConnection(anksčiau Get-Connection)
Remove-AdminPowerAppConnection(anksčiau Pašalinti ryšį)
Skaityti, naujinti ir naikinti ryšio teises Get-AdminPowerAppConnectionRoleAssignment(anksčiau Get-ConnectionRoleAssignment)
Set-AdminPowerAppConnectionRoleAssignment(anksčiau Set-ConnectionRoleAssignment)
Remove-AdminPowerAppConnectionRoleAssignment(anksčiau Remove-ConnectionRoleAssignment)
Perskaitykite ir panaikinkite jungtis Get-AdminPowerAppConnector(anksčiau Get-Connector)
Remove-AdminPowerAppConnector(anksčiau Remove-Connector)
Įtraukite, perskaitykite, naujinkite ir panaikinkite tinkintos jungties leidimus Get-AdminPowerAppConnectorRoleAssignment(anksčiau Get-ConnectorRoleAssignment)
Get-PowerAppConnectorRoleAssignment(anksčiau Set-ConnectorRoleAssignment)
Remove-PowerAppConnectorRoleAssignment(anksčiau Remove-ConnectorRoleAssignment)
Strategijos URL šablonų skaitymas, įtraukimas ir šalinimas Get-PowerAppPolicyUrlPatterns
New-PowerAppPolicyUrlPatterns
Remove-PowerAppPolicyUrlPatterns
Valdymo programų skaitymas, registravimas ir šalinimas Get-PowerAppManagementApp
Get-PowerAppManagementApps
"New-PowerAppManagementApp"
Remove-PowerAppManagementApp
Perskaitykite, kurkite, naujinkite ir importuokite apsaugos raktus Get-PowerAppRetrieveAvailableTenantProtectionKeys
Get-PowerAppGenerateProtectionKey
Get-PowerAppRetrieveTenantProtectionKey
New-PowerAppImportProtectionKey
Set-PowerAppTenantProtectionKey

„Power Apps” „cmdlet”, skirtos administratoriams

Daugiau informacijos apie Power Apps administratorius Power Automate ir "cmdlet" rasite Darbo su PowerShell Power Platform administratoriams pradžia.

Patarimai

  • Naudokite Get-Help ir a CmdletName , kad gautumėte pavyzdžių sąrašą.

    Ekrano kopija, kurioje rodomas komandos Get-Help naudojimas.

  • Įvedę brūkšnį -, galite paspausti Tab , kad peržiūrėtumėte įvesties žymes. Įdėkite šią vėliavėlę po cmdlet pavadinimo.

Komandų pavyzdžiai:

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

Darbiniai pavyzdžiai

Toliau pateikiami keli dažniausiai pasitaikantys scenarijai, rodantys, kaip naudoti naujas ir esamas Power Apps cmdlet.

Aplinkos komandos

Naudokite šias komandas norėdami gauti išsamios informacijos ir atnaujinti savo nuomotojo aplinkas.

Rodyti visų aplinkų sąrašą

Get-AdminPowerAppEnvironment

Pateikia kiekvienos nuomotojo aplinkos sąrašą su išsamia informacija apie kiekvieną iš jų (pvz., aplinkos pavadinimas (guid), rodomas vardas, vieta, kūrėjas ir kt.).

Rodyti išsamią informaciją apie numatytąją aplinką

Get-AdminPowerAppEnvironment –Default

Grąžina išsamią informaciją tik apie nuomotojo numatytąją aplinką.

Rodyti tam tikros aplinkos informaciją

Get-AdminPowerAppEnvironment –EnvironmentName 'EnvironmentName'

Pastaba.

Laukas EnvironmentName yra unikalus identifikatorius, kuris skiriasi nuo DisplayName (žr. pirmąjį ir antrąjį laukus išvestyje kitame paveikslėlyje).

Get-AdminEnvironment komanda.

„Power Apps“ komandos

Šios operacijos naudojamos jūsų nuomotojo „Power Apps“ duomenims nuskaityti ir keisti.

Rodyti visų „Power Apps“ sąrašą

Get-AdminPowerApp

Pateikia visų Power Apps nuomotojo objektų sąrašą su išsamia kiekvieno iš jų informacija (pvz., programos pavadinimas (guid), rodomas vardas, kūrėjas ir kt.).

Rodyti visų „Power Apps“, atitinkančių įvestą rodomą pavadinimą, sąrašą

Get-AdminPowerApp 'DisplayName'

Šioje komandoje pateikiami visi Power Apps jūsų nuomotojo sąrašai, kurie atitinka rodomą pavadinimą.

Pastaba.

Naudokite kabutes aplink įvesties reikšmes, kuriose yra tarpų. Pavyzdžiui, naudokite "Mano programos pavadinimas".

Rekomenduoti programą

Set-AdminPowerAppAsFeatured –AppName 'AppName'

Rekomenduojamos programos yra sugrupuojamos ir „Power Apps mobile“ grotuve keliamos į sąrašo viršų.

Pastaba.

Kaip ir aplinkos, laukas AppName yra unikalus identifikatorius, kuris skiriasi nuo DisplayName. Jei operacijas norite atlikti pagal rodomą pavadinimą, kai kurios funkcijos leis naudoti srautą (žr. kitą funkciją).

Naudojant srautą, paversti srautą pagrindinės reklamjuostės programa

Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero

Mobiliojo grotuvo sąrašo Power Apps viršuje pasirodo pagrindinė programa. Gali būti tik viena pagrindinės reklamjuostės programa.

Vamzdžio | simbolis tarp dviejų cmdlet paima pirmojo cmdlet išvestį ir perduoda ją kaip antrosios įvesties vertę, jei funkcija parašyta taip, kad tilptų vamzdis.

Pastaba.

Prieš pakeičiant programėlę į "Hero", ji jau turi būti speciali programa.

Rodyti kiekvienam vartotojui priklausančių programų skaičių

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

Originalias „PowerShell“ funkcijas galite derinti su „Power Apps“ „cmdlet“ komandomis, kad galėtumėte dar efektyviau manipuliuoti duomenimis. Čia naudojame funkciją „Select“, kad išskirtumėme savininko atributą (objektą) iš Get-AdminApp objekto. Tada perduodami šią išvestį kitai funkcijai „Select“, mes išskiriame savininko objekto pavadinimą. Galiausiai, perdavus antrosios funkcijos „Select“ išvestį funkcijai „Group“, gaunama graži lentelė, kurioje yra kiekvieno savininko programų skaičius.

Get-AdminPowerApp komanda.

Rodyti kiekvienos aplinkos programų skaičių

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

Get-AdminPowerApp aplinka.

Atsisiųsti „Power Apps“ vartotojo informaciją

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

Ankstesnėje komandoje "Power Apps" vartotojo informacija (pagrindinė įvesties vartotojo naudojimo informacija naudojant sistemos vartotojo vardą) saugoma nurodytame teksto faile. Jis sukuria naują failą, jei nėra esamo failo tokiu vardu, ir perrašo tekstinį failą, jei jis jau yra.

Priskirtųjų vartotojų licencijų sąrašo eksportavimas

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

Eksportuoja visas priskirtas vartotojo licencijas („Power Apps“ ir „Power Automate“) į Jūsų nuomotojo lentelės formos rodinio .csv failą. Eksportuotame faile yra savitarnos, registracijos, vidiniai bandomieji planai ir planai, gauti iš Microsoft Entra ID. Vidiniai bandomieji planai nėra matomi administratoriams „Microsoft 365“ administravimo centre.

Nuomotojams, turintiems didelį „Microsoft Power Platform“ vartotojų skaičių, eksportavimas gali užtrukti.

Pastaba.

"Get-AdminPowerAppLicenses cmdlet" išvestis apima tik licencijas vartotojams, kurie prieigą prie "Power Platform" paslaugų (pvz., "Power Apps", "Power Automate" arba "Power Platform" administravimo centrą). Vartotojai, kuriems priskirtos "Microsoft Entra ID" licencijos (paprastai per "Microsoft 365" administravimo centrą), bet niekada neturėdami prieigos prie "Power Platform" paslaugų, neturi savo licencijų, įtrauktų į sugeneruotą .csv išvestį. Be to, kadangi "Power Platform" licencijavimo tarnybos saugo licencijas, "Microsoft Entra" ID licencijų priskyrimų naujinimai gali užtrukti iki septynių dienų, kad atspindėtų vartotojų, kurie neseniai negavo prieigos prie tarnybos, išvestį.

Drobės savininko vaidmens suteikimas prisijungusiam vartotojui

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

Pakeičia Power App savininko vaidmenį į dabartinį vartotoją ir pakeičia pradinį savininką kaip "gali peržiūrėti" vaidmens tipą.

Pastaba.

Laukai AppName ir EnvironmentName yra unikalūs identifikatoriai (guids), o ne rodomi pavadinimai.

Aplinkoje panaikintų drobės programų sąrašo peržiūra

Get-AdminDeletedPowerAppsList -EnvironmentName 'EnvironmentName'

Ši komanda rodo visas neseniai ištrintas drobės programas, nes jos vis tiek gali būti atkurtos.

Panaikintos drobės programos atkūrimas

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

Ši komanda atkuria drobės programą, Get-AdminDeletedPowerAppsList kurią galima aptikti per cmdlet. Bet kurios drobės programos, kuri nerodoma "", Get-AdminDeletedPowerAppsList negalima atkurti.

Paskirta „SharePoint“ tinkintos formos aplinka

Tolesni cmdlets gali būti naudojami siekiant nurodyti ir patikrinti, kurios aplinkos „SharePoint“ tinkintos formos yra įrašytos į ją vietoje numatytosios aplinkos. Pasikeitus pasirinktinėms SharePoint formoms skirtai aplinkai, šioje aplinkoje įrašomos naujai sukurtos pasirinktinės formos. Esančios tinkintos formos automatiškai neperkeliamos į kitas aplinkas, kadangi „cmdlets“ yra naudojami. Galimybė vartotojui sukurti tinkintą formą nustatytoje aplinkoje reikalauja, kad vartotojas turėtų aplinkos kūrėjo vaidmenį. Vartotojams gali būti suteikti aplinkos kūrėjo vaidmenys „Power Platform“ administravimo centre.

Bet kurią aplinką, kuri nėra numatytoji aplinka, galima panaikinti. Jei nurodyta SharePoint pasirinktinė formų aplinka panaikinama, pasirinktinės formos panaikinamos kartu su ja.

Get-AdminPowerAppSharepointFormEnvironment  

Ši komanda pateikia EnvironmentName aplinkos, kuri šiuo metu skirta naujai sukurtoms SharePoint pasirinktinėms formoms, reikšmę. Jei aplinka niekada nebuvo paskirta, numatytoji aplinka yra grąžinama.

Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName' 

Ši komanda nurodo aplinką, naujai sukurtas SharePoint pasirinktines formas įrašyti į, o ne numatytąją aplinką. Esančios tinkintos formos automatiškai neperkeliamos į naujai paskirtą aplinką. Pasirinktinėms formoms SharePoint galima nurodyti tik gamybos aplinką.

Reset-AdminPowerAppSharepointFormEnvironment  

Tai panaikina numatytąją aplinką kaip paskirtą aplinką siekiant įrašyti „SharePoint“ tinkintas formas.

Nuomotojo parametro, suteikiančio galimybę bendrinti programas su visais, rodymas

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

Šis parametras valdo, ar vartotojai, turintys aplinkos kūrėjas saugos vaidmuo, gali bendrinti drobės programas su visais organizacijos nariais. Kai parametras nustatytas kaip teisingas, tik vartotojai, turintys administratoriaus vaidmenį (Dynamics 365 administratorius, Power Platform tarnybos administratorius, Microsoft Entra nuomotojo administratorius), gali bendrinti taikomąsias programas su visais organizacijos nariais.

Neatsižvelgiant į šią nuomotojo parametrų reikšmę, kūrėjai, turintys bendrinimo teisę, gali bendrinti programas su bet kokio dydžio saugos grupėmis. Šis valdiklis tik nustato, ar bendrinant galima naudoti trumpinį Visi .

Nuomotojo parametro keitimas, kad būtų galima bendrinti programas su visais

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

Jūsų organizacijos valdymo klaidų pranešimų turinio rodymas

Jei nurodysite, kad valdymo klaidos pranešimo turinys būtų rodomas klaidų pranešimuose, klaidos pranešimo turinys bus rodomas, kai kūrėjai pastebės, kad neturi teisės bendrinti programų su visais. Žiūrėkite: „PowerShell” valdymo klaidų pranešimų turinio komandos.

Konteksto srautų susiejimas su programa

Susiekite programos konteksto srautus su programa, kad sukurtumėte priklausomybę tarp programos ir srautų. Jei norite sužinoti daugiau apie konteksto srautus, žr. Kokios „Power Automate“galimybės įtrauktos į „Power Apps“ licencijas?

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

„EnvironmentName“ ir „FlowName“ galima rasti srautų URL:

  • Ne sprendimo srauto URL atrodo taip:

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

    GUID po environments/ yra EnvironmentName, o GUID po flows/ yra FlowName

  • Sprendimo srauto URL atrodo taip:

    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 po environments/ yra EnvironmentName, o GUID po flows/ yra FlowName

  • Drobės programos "AppName" galite rasti drobės programos išsamios informacijos puslapyje.

    Ekrano kopija, kurioje rodoma, kad drobės programos

  • Modeliu pagrįstos programos "AppName" galima rasti sprendimų naršyklėje.

    Ekrano kopija, kurioje rodoma, kad modeliu pagrįstos programos

  • Norėdami peržiūrėti pavyzdžius, įveskite: get-help Add-AdminFlowPowerAppContext -examples.

  • Norėdami gauti daugiau informacijos, įveskite: get-help Add-AdminFlowPowerAppContext -detailed.

  • Norėdami gauti techninę informaciją, įveskite: get-help Add-AdminFlowPowerAppContext -full

Programos konteksto srautų pašalinimas

Pašalinkite priklausomybę tarp srautų ir programos, naudodami toliau nurodytą „PowerShell“ komandą. „Remove-AdminFlowPowerAppContext“ pašalina programos kontekstą iš konkretaus srauto.

    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“ komandos

Naudokite šias svarbias komandas, kad atliktumėte su tuo susijusį Power Automate administravimą.

Visą administratoriams skirtų "cmdlet" ir " Power Automate cmdlet" komandų sąrašą rasite Power Apps Darbo su PowerShell administratoriams Power Platform pradžia.

Rodyti visus srautus

Get-AdminFlow

Grąžina visų nuomotojo srautų sąrašą.

Rodyti srauto savininko vaidmens informaciją

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

Grąžina nurodyto srauto savininko informaciją.

Pastaba.

Kaip ir Environments and,FlowName PowerApps yra unikalus identifikatorius (guid), kuris skiriasi nuo rodomo srauto pavadinimo.

Rodyti srauto vartotojo informaciją

Get-AdminFlowUserDetails –UserId $Global:currentSession.userId

Grąžina vartotojo informaciją apie srauto naudojimą. Šiame pavyzdyje kaip įvestį naudojame dabartinio prisijungusio PowerShell seanso naudotojo ID.

Šalinti srauto vartotojo informaciją

Remove-AdminFlowUserDetails –UserId 'UserId'

Iš „Microsoft“ duomenų bazės pašalina visa srauto vartotojo informacija. Prieš išvalant srauto vartotojo informaciją, turi būti panaikinti visi srautai, priklausantys įvestam vartotojui.

Pastaba.

Laukas UserId yra vartotojo Microsoft Entra įrašo objekto ID, kurį galima rasti Azure portalo dalyje Microsoft Entra ID>Vartotojo>profilio>objekto ID. Tam, kad galėtumėte pasiekti čia esančius duomenis, turite būti administratorius.

Eksportuoti visus srautus į CSV failą

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

Visi nuomotojo srautai eksportuojami į .csv failą.

Srautų įtraukimas į Dataverse sprendimus

Add-AdminFlowsToSolution -EnvironmentName <String>

Perkelia visus neišspręstus srautus į aplinką.

Parametrų variacijos gali būti naudojamos norint perkelti tik konkrečius srautus, įtraukti į konkretų sprendimą arba perkelti tik nustatytą srautų skaičių vienu metu.

Techninės informacijos ieškokite Add-AdminFlowsToSolution.

Http veiksmų srautų sąrašas

Get-AdminFlowWithHttpAction -EnvironmentName <String>

Išvardija srautus su HTTP veiksmu (-ais).

DisplayName Srauto pavadinimas EnvironmentName
Gauti sąskaitą faktūrą HTTP 1 srautas aplinka–1
Mokėti sąskaitą faktūrą iš taikomosios programos 2 srautas aplinka–2
Derinti paskyrą 3 srautas aplinka –3

API ryšio komandos

Peržiūrėti ir valdyti nuomotojo API ryšius.

Rodyti visus originalius ryšius numatytoje aplinkoje

Get-AdminPowerAppEnvironment -Default | Get-AdminPowerAppConnection

Pateikiamas visų API ryšių, kurie yra numatytoje aplinkoje, sąrašas. Savuosius ryšius galima rasti skirtuke Dataverse>Ryšiai, esančiame Power Apps.

Rodyti visas pritaikytas nuomotojo jungtis

Get-AdminPowerAppConnector

Grąžina visų nuomotojo pritaikytų jungčių sąrašą.

Pastaba.

Get-AdminPowerAppConnector nepateikia pasirinktinių jungčių, kurios yra sprendime, sąrašo. Tai yra žinomas apribojimas.

Duomenų strategijos komandos

Šios "cmdlet" valdo jūsų nuomotojo duomenų strategijas.

Duomenų strategijos kūrimas

New-DlpPolicy

Sukuria naują prisijungusio administratoriaus nuomotojo duomenų strategiją.

Duomenų strategijos objektų sąrašo gavimas

Get-DlpPolicy

Gaunami prisijungusio administratoriaus nuomotojo strategijos objektai.

Pastaba.

  • Kai peržiūrite duomenų strategiją naudodami "PowerShell", rodomas jungčių pavadinimas yra nuo tada, kai buvo sukurta duomenų strategija arba kai jungtys paskutinį kartą buvo perkeltos strategijoje. Nauji jungčių rodomų pavadinimų pakeitimai neatsispindi.
  • Kai peržiūrite duomenų strategiją naudodami "PowerShell", nepateikiamos naujos numatytosios grupės jungtys, kurios nebuvo perkeltos.

Abiejų šių žinomų problemų sprendimas yra perkelti paveiktą jungtį į kitą strategijos grupę ir tada perkelti ją atgal į tinkamą grupę. Tai atlikus, visos jungtys matomos su teisingu pavadinimu.

Duomenų strategijos naujinimas

Set-DlpPolicy

Atnaujinama strategijos informacija, pvz., jos rodomas pavadinimas.

Strategijos pašalinimas

Remove-DlpPolicy

Panaikina duomenų strategiją.

Duomenų išteklių išimties cmdlet

Šios "cmdlet" leidžia išskirti arba pašalinti iš strategijos konkretų išteklių.

Gauti esamą duomenų strategijos išimties išteklių sąrašą

Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Duomenų strategijos naujo išimties išteklių sąrašo kūrimas

New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources 

Duomenų strategijos išimties išteklių sąrašo naujinimas

Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources 

Duomenų strategijos išimties išteklių sąrašo šalinimas

Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Jei norite ištekliaus netaikyti duomenų strategijai, jums reikia šios informacijos:

  • Nuomotojo ID (GUID)
  • Duomenų strategijos ID (GUID)
  • Ištekliaus ID (baigiasi su GUID)
  • Išteklių tipas

Galite nuskaityti ištekliaus ID ir įvesti tekstą naudodami "PowerShell" "cmdlets Get-PowerApp" programoms ir "Get flow" srautams.

Pašalinimo scenarijaus pavyzdys

Norėdami atleisti srautą naudodami ID f239652e-dd38-4826-a1de-90a2aea584d9 ir programą su ID, 06002625-7154-4417-996e-21d7a60ad624 galime paleisti šias cmdlet:

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

Duomenų strategijos išimties patirtis šiuose scenarijuose

# Scenarijus Aplinka
1 Vartotojas paleidžia taikomąją programą, kuri neatitinka duomenų strategijos, bet yra išimtis iš duomenų strategijos. Programų paleidimas vykdomas su duomenų strategijos vykdymu arba be jo.
2 "Maker" įrašo taikomąją programą, kuri neatitinka duomenų strategijos reikalavimų, bet yra išimtis iš duomenų strategijos Su duomenų strategijos išimtimi arba be jos, duomenų strategijos atitiktis neužblokuoja programėlės įrašymo operacijos. Duomenų strategijos neatitikimo įspėjimas rodomas neatsižvelgiant į duomenų strategijos išimtį.
3 "Maker" įrašo srautą, kuris neatitinka duomenų strategijos, bet duomenų strategijos išimtis Su duomenų strategijos išimtimi arba be jos, duomenų strategijos atitiktis neužblokuoja srauto įrašymo operacijos. Nerodomas duomenų strategijos neatitikimo įspėjimas.

Valdymo klaidų pranešimų turinio komandos

Toliau nurodytos cmdlet gali nukreipti galutinius vartotojus į jūsų organizacijos valdymo informacinę medžiagą. Komanda apima valdymo dokumentų susieti ir valdymo kontaktą, kai juos paragina valdymo valdikliai. Pvz., kai nustatytas valdymo klaidos pranešimo turinys, jis rodomas "Power Apps" duomenų strategijos vykdymo laiko vykdymo pranešimuose.

Valdymo klaidų pranešimų turinio nustatymas

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

Valdymo klaidos pranešimo URL ir el. laiškas gali būti rodomi atskirai arba kartu. Galite įjungti arba išjungti valdymo klaidos pranešimą lauke enabled .

Valdymo klaidos pranešimo turinio scenarijai

# Scenarijus Pasiekiamumas
1 Vartotojas paleidžia programą, sukurtą naudojant "Power Apps", kuri neatitinka duomenų strategijos Bendrai pasiekiama
2 Kūrėjas bendrina „Power Apps” drobės programą, bet neturi bendrinimo teisės Bendrai pasiekiama
3 "Maker" bendrina Power Apps drobės programą su "Everyone", bet neturi teisės bendrinti su "Everyone" Bendrai pasiekiama
4 "Maker" įrašo programėlę, sukurtą naudojant "Power Apps", kurios neatitinka duomenų strategijos reikalavimų Bendrai pasiekiama
5 "Maker" įrašo "Power Automate" srautą, kuris neatitinka duomenų strategijos Bendrai pasiekiama
6 Vartotojas paleidžia programą be saugos grupės narystės saugos grupėje, susietoje su Dataverse aplinka Bendrai pasiekiama

Valdymo klaidų pranešimų turinio rodymas

Get-PowerAppDlpErrorSettings -TenantId 'TenantId' 

Valdymo klaidų pranešimų turinio atnaujinimas

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

Įgalinti duomenų strategiją dėl ryšių pažeidimo – aplinka

Šios "cmdlet" leidžia įgalinti duomenų strategiją, kad būtų pažeisti ryšiai aplinkos arba nuomotojo lygiu.

Įgalinti duomenų strategijas, kad būtų pažeisti ryšiai

Galite įgalinti duomenų strategijas ryšiams aplinkoje. Vykdymas išjungia esamus ryšius, kurie pažeidžia duomenų strategijas, ir įgalina anksčiau išjungtus ryšius, kurie nebepažeidžia duomenų strategijų.

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName [Environment ID]
Aplinkos vykdymo scenarijaus pavyzdys
Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName c4a07cd6-cb14-e987-b5a2-a1dd61346963 

Įgalinti duomenų strategijas dėl ryšių pažeidimo – nuomotojas

Galite įgalinti nuomotojo ryšių duomenų strategijas. Vykdymas išjungia esamus ryšius, kurie pažeidžia duomenų strategijas, ir įgalina anksčiau išjungtus ryšius, kurie nebepažeidžia duomenų strategijų.

Start-DLPEnforcementOnConnectionsInTenant

Blokuoti bandomosios versijos licencijų komandas

Komandos:

Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans

Leidžiamų sutikimo planų cmdlet galima naudoti norint įtraukti arba šalinti prieigą prie konkretaus tipo sutikimo plano iš nuomotojo. „Vidiniai” sutikimo planai yra bandomosios licencijos arba kūrėjų planai, prie kurių vartotojai gali prisiregistruoti per „Power Apps” / „Power Automate” portalus / „Power Automate“, skirtą kompiuteriui. "Ad hoc prenumeratos" arba "virusinės" sutikimo planai yra bandomosios versijos, prie kurių vartotojai gali prisiregistruoti https://signup.microsoft.com. Administratoriai gali priskirti vartotojus naudodami Microsoft Entra ID arba administravimo portalą Microsoft 365 .

Pagal numatytuosius parametrus nuomotojui leidžiami visų tipų sutikimo planai. Tačiau "Power Platform" administratorius gali norėti neleisti vartotojams priskirti sau bandomosios versijos licencijų, tačiau išsaugoti galimybę priskirti bandomąsias licencijas vartotojų vardu. Šią taisyklę galima atlikti naudojant komandą Remove-AllowedConsentPlans -Types "Internal" ir neleidžiant parametro Update-MgPolicyAuthorizationPolicy -AllowedToSignUpEmailBasedSubscriptions " "Microsoft Entra ID".

Svarbu

Kai naudojate Remove-AllowedConsentPlans, visi esami nurodyto tipo planai pašalinami iš visų nuomotojo vartotojų ir jų atkurti negalima. Ši komanda blokuoja visus būsimus tokio tipo priskyrimus. Power Platform Jei administratorius nori iš naujo įjungti tokio tipo planus, jie gali naudoti Add-AllowedConsentPlans. Jei jie nori peržiūrėti dabartinę leidžiamų sutikimo planų būseną, jie gali naudoti Get-AllowedConsentPlans.

Jei turite klausimų

Jei turite komentarų, pasiūlymų ar klausimų, paskelbkite juos "Power Apps" administravimo bendruomenės lentoje.