Podpora prostredia PowerShell pre Power Apps a Power Automate

Pomocou PowerShell cmdletov pre Power Platform tvorcov a správcov môžete automatizovať mnohé úlohy monitorovania a správy. Úlohy, ktoré sú možné len manuálne dnes v Power AppsPower Automate alebo v centre spravovania Power Platform.

Cmdlets

Cmdlets sú funkcie napísané v PowerShell skriptovom jazyku, ktoré vykonávajú príkazy v PowerShell. Spustením týchto Power Apps rutín typu cmdlet môžete pracovať s platformou podnikových aplikácií bez toho, aby ste museli prechádzať portálom na správu vo webovom prehliadači.

Môžete kombinovať cmdlety s inými PowerShell funkciami a písať zložité skripty, ktoré môžu optimalizovať váš pracovný tok. Rutiny cmdlet môžete stále používať, ak nie ste správcom nájomníka, ale ste obmedzený na zdroje, ktoré vlastníte. Účet správcu používa rutiny cmdlet, ktoré začínajú Admin.

Cmdlets sú k dispozícii v galérii PowerShell ako dva samostatné moduly:

• Správca
• Tvorca

Informácie o module správcu Power Apps nájdete v téme Začíname pomocou modulu správcu Power Apps a Microsoft.PowerApps.Administration.PowerShell.

Začnite s PowerShell

Ak ste novým používateľom PowerShell a potrebujete pomoc s jeho nájdením a spustením, prejdite na stránku Začíname s PowerShell. Ak potrebujete pomoc s používaním PowerShell alebo cmdletov, prejdite na Systém pomoci PowerShell.

Požiadavky na prostredie PowerShell

Prostredie PowerShell v tomto článku vyžaduje Windows PowerShell verziu 5.x. Ak chcete skontrolovať verziu PowerShell bežiacu na vašom počítači, spustite nasledujúci príkaz:

$PSVersionTable.PSVersion

Ak máte zastaranú verziu, prejdite na Okraďovanie existujúcich Windows prostredia PowerShell.

Dôležité

Moduly popísané v tomto dokumente používajú rozhranie .NET Framework, ktoré je nekompatibilné s prostredím PowerShell 6.0 a novším. Tieto novšie verzie používajú .NET Core.

Inštalácia modulu a prihlásenie

Ak chcete spustiť PowerShell cmdlets pre tvorcov aplikácií:

1. Spustite PowerShell ako správca.

   

2. Importujte potrebné moduly.

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

   Prípadne, ak nemáte na svojom počítači práva správcu, použite na inštaláciu parameter -Scope CurrentUser .

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

3. Ak sa zobrazí výzva na prijatie zmeny InstallationPolicy hodnoty úložiska, prijmite [A] Yes na všetky moduly zadaním A, potom stlačte Enter pre každý modul.

   

4. Voliteľne môžete pred prístupom k príkazom poskytnúť svoje poverenia. Prihlasovacie údaje sa obnovujú až osem hodín, kým sa budete musieť znova prihlásiť. Ak pred vykonaním príkazu neposkytnete poverenia, zobrazí sa výzva na zadanie poverení.

   # 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. Voliteľne možno zacieliť na konkrétny koncový bod. Predvolený koncový bod je prod. Ak chce používateľ spustiť skript PowerShell zameraný na prostredie v neprodukčnej oblasti, ako je napríklad GCC, -Endpoint parameter je možné zmeniť na usgov pre režim GCC Moderate (Moderovanie v prostredí GCC High) alebo usgovhigh gcc high (GCC dod DOD). Úplný zoznam podporovaných koncových bodov je: "prod,verzia Preview,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" 
   

Aktualizácie modulov

Verziu všetkých svojich PowerShell modulov môžete skontrolovať pomocou Get-Module.

Get-Module

A všetky svoje PowerShell moduly môžete aktualizovať na najnovšie pomocou Aktualizačného modulu.

Update-Module

Prípadne skontrolujte verziu Power Platform modulov pomocou parametra Get-Module a -Name .

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

Aktualizujte moduly Power Platform PowerShell pomocou parametra Update-Module a -Name .

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

Power Apps rutín typu cmdlet pre tvorcov aplikácií

Požiadavky na Power Apps rutiny typu cmdlet

Používatelia s platnou licenciou Power Apps môžu vykonávať operácie v týchto rutinách typu cmdlet. Majú však prístup iba k zdrojom, ako sú aplikácie a postupy, ktoré sú s nimi vytvorené alebo zdieľané.

Zoznam Cmdlet – Cmdlets tvorcu

Poznámka

V najnovšom vydaní sme aktualizovali niektoré názvy funkcií rutín typu cmdlet s cieľom pridať vhodné predpony na predchádzanie vzniku kolízií. Prehľad o tom, čo sa zmenilo, nájdete v nasledujúcej tabuľke.

Purpose	Cmdlet
Pridanie plátnovej aplikácie do riešenia Microsoft Dataverse	Set-PowerAppAsSolutionAware
Čítanie a aktualizácia prostredí	Get-AdminPowerAppEnvironment(predtým Get-PowerAppsEnvironment) Get-FlowEnvironment Restore-PowerAppEnvironment(predtým Restore-AppVersion)
Čítať, aktualizovať a mazať aplikáciu na plátne	Get-AdminPowerApp(predtým Get-App) Remove-AdminPowerApp(predtým Remove-App) Publish-AdminPowerApp (predtým Publish-App)
Čítať, aktualizovať a mazať oprávnenia aplikácie na plátne	Get-AdminPowerAppRoleAssignment(predtým Get-AppRoleAssignment) Remove-AdminPowerAppRoleAssignment(predtým Remove-AppRoleAssignment)
Čítať, aktualizovať a mazať tok	Get-AdminFlow Enable-AdminFlow Disable-AdminFlow Remove-AdminFlow
Čítať, aktualizovať a mazať oprávnenia toku	Get-AdminFlowOwnerRole Set-AdminFlowOwnerRole Remove-AdminFlowOwnerRole
Čítajte a reagujte na schválenie toku	Get-AdminFlowApprovalRequest Remove-AdminFlowApprovals
Čítanie a mazanie spojení	Get-AdminPowerAppConnection(predtým Get-Connection) Remove-AdminPowerAppConnection(predtým Remove-Connection)
Čítať, aktualizovať a mazať oprávnenia pripojenia	Get-AdminPowerAppConnectionRoleAssignment(predtým Get-ConnectionRoleAssignment) Set-AdminPowerAppConnectionRoleAssignment(predtým Set-ConnectionRoleAssignment) Remove-AdminPowerAppConnectionRoleAssignment(predtým Remove-ConnectionRoleAssignment)
Čítanie a mazanie konektorov	Get-AdminPowerAppConnector(predtým Get-Connector) Remove-AdminPowerAppConnector(predtým Remove-Connector)
Pridávanie, čítanie aktualizácia a odstraňovanie povolení vlastných konektorov	Get-AdminPowerAppConnectorRoleAssignment(predtým Get-ConnectorRoleAssignment) Get-PowerAppConnectorRoleAssignment(predtým Set-ConnectorRoleAssignment) Remove-PowerAppConnectorRoleAssignment(predtým Remove-ConnectorRoleAssignment)
Čítajte, pridávajte a odstraňujte vzory adries URL pre politiky	Get-PowerAppPolicyUrlPatterns New-PowerAppPolicyUrlPatterns Remove-PowerAppPolicyUrlPatterns
Čítajte, registrujte a odstraňujte aplikácie na spravovanie	Get-PowerAppManagementApp Get-PowerAppManagementApps New-PowerAppManagementApp Remove-PowerAppManagementApp
Čítanie, vytváranie, aktualizácia a import ochranných kľúčov	Get-PowerAppRetrieveAvailableTenantProtectionKeys Get-PowerAppGenerateProtectionKey Get-PowerAppRetrieveTenantProtectionKey New-PowerAppImportProtectionKey Set-PowerAppTenantProtectionKey

Power Apps rutín typu cmdlet pre správcov

Ďalšie informácie o Power Apps a rutinách typu cmdlet pre Power Automate pre správcov nájdete v téme Začíname sa s prostredím PowerShell pre správcov Power Platformy.

Tipy

• Použite Get-Help nasledované a CmdletName na získanie zoznamu príkladov.

  

• Po zadaní pomlčky - môžete stlačením Tab prechádzať vstupnými značkami. Umiestnite tento príznak za názov cmdlet.

Príklady príkazov:

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

Príklady operácií

Nižšie sú uvedené niektoré bežné scenáre, ktoré zobrazujú, ako používať nové a existujúce Power Apps rutiny typu cmdlet.

• Príkazy prostredia
• príkazy Power Apps
• príkazy Power Automate
• Príkazy na pripojenie API
• Príkazy politiky používania údajov
• Rutiny typu cmdlet na oslobodenie zdrojov údajov
• Blokovať príkazy skúšobných licencií

Príkazy prostredia

Pomocou týchto príkazov získate podrobnosti a aktualizujte prostredia svojho nájomcu.

Zobrazí sa zoznam všetkých prostredí.

Get-AdminPowerAppEnvironment

Vráti zoznam každého prostredia v rámci vášho nájomníka s podrobnosťami o každom (napríklad názov prostredia (guid), zobrazovaný názov, umiestnenie, tvorca a ďalšie).

Zobraziť podrobnosti vášho predvoleného prostredia

Get-AdminPowerAppEnvironment –Default

Vracia podrobnosti iba pre predvolené prostredie nájomcu.

Zobraziť podrobnosti o konkrétnom prostredí

Get-AdminPowerAppEnvironment –EnvironmentName 'EnvironmentName'

Poznámka

Pole EnvironmentName je jedinečný identifikátor, ktorý sa líši od Zobrazovaného názvu (pozri prvé a druhé pole v výstup na nasledujúcom obrázku).

príkazy Power Apps

Tieto operácie sa používajú na čítanie a úpravu Power Apps údajov v nájomníkovi.

Zobrazenie zoznamu všetkých Power Apps

Get-AdminPowerApp

Vráti zoznam všetkých Power Apps v rámci nájomníka s podrobnosťami o jednotlivých aplikáciách (napríklad názov aplikácie (identifikátor guid), zobrazovaný názov, tvorca a ďalšie údaje).

Zobrazenie zoznamu všetkých Power Apps, ktoré zodpovedajú zobrazovanému vstupnému názvu

Get-AdminPowerApp 'DisplayName'

Tento príkaz uvádza všetky Power Apps v nájomníkovi, ktoré zodpovedajú zobrazovanému názvu.

Poznámka

Použite úvodzovky okolo vstupných hodnôt, ktoré obsahujú medzery. Použite napríklad „Názov mojej aplikácie“.

Využitie aplikácie

Set-AdminPowerAppAsFeatured –AppName 'AppName'

Odporúčané aplikácie sa zoskupia a posunú do hornej časti zoznamu v mobilnom prehrávači Power Apps.

Poznámka

Podobne ako v prostrediach je pole AppName jedinečným identifikátorom, ktorý sa líši od Zobrazovaného názvu. Ak chcete vykonávať operácie na základe zobrazovaného názvu, niektoré funkcie vám umožnia použiť potrubie (pozri nasledujúcu funkciu).

Pomocou kanála vytvorte z aplikácie hlavnú aplikáciu

Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero

Hrdinová aplikácia sa zobrazí v hornej časti zoznamu v mobilnom prehrávači Power Apps. Môže existovať iba jedna hlavná aplikácia.

Znak zvislej čiary | medzi dvoma rutinami cmdlet prevezme výstup prvej rutiny a odovzdá ho ako vstupnú hodnotu druhej rutiny, ak je funkcia napísaná tak, aby sa do nej zmestila.

Poznámka

Aplikácia musí byť odporúčaná ešte predtým, než sa zmení na hlavnú.

Zobrazte počet aplikácií, ktoré vlastní každý používateľ

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

Natívne funkcie prostredia PowerShell môžete skombinovať s Power Apps rutinami typu cmdlet a vylepšiť prácu s údajmi. Tu používame funkciu Výber na izoláciu atribútu Vlastník (objekt) od objektu Get-AdminApp. Potom izolujeme meno objektu vlastníka tak, že výstup prenesieme do inej funkcie Výber. Nakoniec odovzdanie druhého výstupu funkcie Select do funkcie Group vráti peknú tabuľku, ktorá obsahuje počet aplikácií každého vlastníka.

Zobrazte počet aplikácií v každom prostredí

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

Stiahnutie Power Apps podrobností o používateľovi

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

Predchádzajúci príkaz ukladá Power Apps podrobnosti o používateľovi (základné informácie o používateľovi vstupu prostredníctvom hlavného mena používateľa) do zadaného textového súboru. Vytvorí nový súbor, ak neexistuje žiadny súbor s týmto názvom, a prepíše textový súbor, ak už existuje.

Export zoznamu pridelených používateľských licencií

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

Exportuje všetky priradené používateľské licencie (Power Apps a Power Automate) vo vašom nájomníkovi do tabuľkového zobrazenia .csv súboru. Exportovaný súbor obsahuje samoobslužné plány, registráciu, interné skúšobné plány a plány pochádzajúce zo Microsoft Entra ID. Interné skúšobné plány sa správcom v Centre spravovania Microsoft 365 nezobrazujú.

Export môže chvíľu trvať, kým sa export uskutoční pre nájomníkov s veľkým počtom Microsoft Power Platform používateľov.

Poznámka

Výstup rutiny typu cmdlet pre Get-AdminPowerAppLicenses zahŕňa len licencie pre používateľov, ktorí pristupovali k službám Power Platform (napríklad Power Apps, Power Automate alebo Centrum spravovania Power Platformy). Používatelia, ktorí mali licencie priradené v Microsoft Entra ID (zvyčajne prostredníctvom Centra spravovania Microsoft 365), ale nikdy nepristupovali k službám Power Platform, nemajú licencie zahrnuté vo vygenerovanom výstupe .csv. Navyše keďže licenčné služby Power Platform ukladajú licencie do vyrovnávacej pamäte, môže trvať až sedem dní, kým sa aktualizácie priradené licencií v Microsoft Entra ID budú odrážať vo výstupe pre používateľov, ktorí nedávno nemali prístup k službe.

Nastavenie prihláseného používateľa ako vlastníka aplikácie plátna

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

Zmení rolu vlastníka Power App na aktuálneho používateľa a nahradí pôvodného vlastníka ako typ roly „môže zobraziť“.

Poznámka

Polia AppName a EnvironmentName sú jedinečné identifikátory (guid), nie zobrazované názvy.

Zobrazenie zoznamu odstránených aplikácií plátna v prostredí

Get-AdminDeletedPowerAppsList -EnvironmentName 'EnvironmentName'

Tento príkaz zobrazí všetky nedávno odstránené aplikácie plátna, pretože môžu byť stále obnovené. Regenerovateľné trvanie je 28 dní. Žiadna aplikácia odstránená po 28 dňoch sa v tomto zozname nevráti a nedá sa obnoviť.

Obnovte odstránenú aplikáciu na plátne

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

Tento príkaz obnoví aplikáciu canvas, ktorú je možné zistiť prostredníctvom cmdlet Get-AdminDeletedPowerAppsList . Žiadna aplikácia na plátne, ktorá nie je zobrazená v Get-AdminDeletedPowerAppsList , nie je možné obnoviť.

Vytvorenie SharePoint prostredia vlastného formulára

Na určenie a overenie prostredia SharePoint ukladania vlastných formulárov namiesto predvoleného prostredia možno použiť nasledujúce rutiny typu cmdlet. Keď sa zmení určené prostredie pre SharePoint vlastné formuláre, toto prostredie je miesto, kde sú uložené novovytvorené vlastné formuláre. Existujúce vlastné formuláre sa automaticky nemigrujú do rôznych prostredí, pretože sa používajú tieto rutiny cmdlet. Schopnosť používateľa vytvoriť vlastný formulár v určenom prostredí vyžaduje, aby mal tento používateľ rolu Environment Maker. Používateľom je možné udeliť rolu Environment Maker v centre spravovania Power Platform.

Akékoľvek prostredie, ktoré nie je predvoleným prostredím, je možné odstrániť. Ak sa odstráni určená SharePoint prostredie vlastného formulára, vlastné formuláre sa odstránia s ním.

Get-AdminPowerAppSharepointFormEnvironment  

Tento príkaz vráti EnvironmentName pre prostredie aktuálne určené pre novovytvorené SharePoint vlastné formuláre. Ak prostredie nikdy nebolo určené, vráti sa predvolené prostredie.

Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName' 

Tento príkaz určí prostredie, ktoré bolo novovytvorené SharePoint vlastné formuláre uložiť do predvoleného prostredia. Existujúce vlastné formuláre sa automaticky nemigrujú do novo určeného prostredia. Pre SharePoint vlastné formuláre môže byť určené len produkčné prostredie.

Reset-AdminPowerAppSharepointFormEnvironment  

Tým sa predvolené prostredie resetuje ako určené prostredie na ukladanie SharePoint vlastných formulárov.

Zobraziť nastavenie nájomníka pre možnosť zdieľať aplikácie s Všetci

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

Toto nastavenie určuje, či používatelia s tvorca prostredia rola zabezpečenia môžu zdieľať aplikácie plátna s Všetkým v organizácii. Keď je nastavenie nastavené na hodnotu true môžu aplikácie zdieľať s .

Bez ohľadu na túto hodnotu nastavení nájomníka môžu tvorcovia s privilégiom zdieľania zdieľať aplikácie so skupinami zabezpečenia ľubovoľnej veľkosti. Tento ovládací prvok iba určuje, či je možné pri zdieľaní použiť skratku Všetci .

Zmeňte nastavenie nájomníka na možnosť zdieľať aplikácie s Všetci

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

Surface obsahu chybového hlásenia o riadení vo vašej organizácii

Ak určíte obsah chybovej správy o riadení, ktorý sa má zobrazovať v chybových správach, obsah chybovej správy sa zobrazí, keď tvorcovia zistia, že nemajú povolenie na zdieľanie aplikácií s Všetci. Prečítajte si Príkazy obsahu správy o chybových správach spracovania PowerShell.

Priradenie postupov v kontexte k aplikácii

Priraďte postupy v kontexte aplikácie k aplikácii, aby ste vytvorili závislosť medzi aplikáciou a postupmi. Ďalšie informácie o kontextových postupoch nájdete v téme Čo sú možnosti Power Automate súčasťou licencií Power Apps?

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

EnvironmentName a FlowName možno nájsť v adrese URL postupu:

• V prípade postupu bez riešenia vyzerá adresa URL takto:

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

  GUID za environments/ je názov prostredia a GUID za flows/ je názov toku

• Pre postup riešenia vyzerá adresa URL takto:

  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 za environments/ je názov prostredia a GUID za flows/ je názov toku

• Názov aplikácie pre aplikáciu na plátne nájdete na stránke s podrobnosťami o aplikácii plátna.

  

• Názov aplikácie pre modelom riadenú aplikáciu nájdete v prieskumníkovi riešení.

  

• Ak chcete zobraziť príklady, zadajte: get-help Add-AdminFlowPowerAppContext -examples.

• Ak chcete získať ďalšie informácie, napíšte: get-help Add-AdminFlowPowerAppContext -detailed.

• Ak chcete získať technické informácie, zadajte: get-help Add-AdminFlowPowerAppContext -full.

Odstránenie postupov v kontexte z aplikácie

Odstráňte závislosť medzi postupmi a aplikáciou pomocou tohto príkazu PowerShell. Remove-AdminFlowPowerAppContext odstráni kontext aplikácie z konkrétneho postupu.

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

príkazy Power Automate

Nasledujúce dôležité príkazy môžete použiť na vykonávanie spravovania súvisiaceho s Power Automate.

Úplný zoznam Power Automate a rutín typu cmdlet pre Power Apps pre správcov nájdete v téme Začíname sa s prostredím PowerShell pre správcov Power Platformy.

Zobraziť všetky toky

Get-AdminFlow

Vráti zoznam všetkých tokov v nájomcovi.

Zobraziť podrobnosti o role vlastníka toku

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

Vráti podrobnosti o vlastníkovi zadaného toku.

Poznámka

Podobne ako Prostredia a PowerApps, Názov toku je jedinečný identifikátor (guid), ktorý je odlišný od zobrazovaného názvu toku.

Zobraziť podrobnosti používateľa toku

Get-AdminFlowUserDetails –UserId $Global:currentSession.userId

Vráti informácie o používateľovi týkajúce sa využitia toku. V tomto príklade používame ako vstup ID používateľa aktuálne prihláseného používateľa relácie PowerShell.

Odstrániť podrobnosti používateľa toku

Remove-AdminFlowUserDetails –UserId 'UserId'

Úplne odstráni podrobnosti o používateľovi toku z databázy Microsoft. Všetky toky, ktoré vlastní používateľ vstupu, sa musia vymazať pred vymazaním podrobností o tokoch.

Poznámka

Pole UserId je ID objektu záznamu Microsoft Entra používateľa, ktoré možno nájsť na portáli Azure v časti Microsoft Entra ID>< ProfileObject ID. Na prístup k týmto údajom odtiaľto musíte byť správcom.

Exportovať všetky toky do súboru CSV

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

Exportuje všetky toky vo vašom nájomcovi do tabuľkového súboru .csv.

Pridajte toky do Dataverse riešení

Add-AdminFlowsToSolution -EnvironmentName <String>

Migruje všetky toky neriešenia v prostredí.

Variácie parametrov možno použiť na migráciu iba špecifických tokov, pridanie do konkrétneho riešenia alebo migráciu iba nastaveného počtu tokov naraz.

Technické podrobnosti nájdete v časti Add-AdminFlowsToSolution.

Zoznam postupov akcií HTTP

Get-AdminFlowWithHttpAction -EnvironmentName <String>

Zoznam postupov s akciami HTTP.

Zobrazované meno	Názov postupu	EnvironmentName
Získať faktúru HTTP	postup –1	environment-1
Faktúra platenia z aplikácie	postup – 2	environment-2
Konto Reconcile	postup – 3	environment-3

Príkazy na pripojenie API

Zobrazte a spravujte pripojenia API vo svojom nájomcovi.

Zobraziť všetky natívne pripojenia vo vašom predvolenom prostredí

Get-AdminPowerAppEnvironment -Default | Get-AdminPowerAppConnection

Zobrazí zoznam všetkých pripojení API, ktoré máte v predvolenom prostredí. Natívne pripojenia sa nachádzajú v Dataverse>Pripojenia na karte Power Apps.

Zobrazenie všetkých vlastných konektorov v nájomcovi

Get-AdminPowerAppConnector

Vráti zoznam všetkých vlastných podrobností konektora v nájomcovi.

Poznámka

Get-AdminPowerAppConnector neuvádza vlastné konektory, ktoré sú v riešení. Toto je známe obmedzenie.

Príkazy politiky používania údajov

Tieto rutiny typu cmdlet riadia politiky používania údajov v nájomníkovi.

Vytvorenie politiky používania údajov

New-DlpPolicy

Vytvorí pre nájomníka prihláseného správcu novú politiku údajov.

Načítanie zoznamu objektov politiky údajov

Get-DlpPolicy

Získa objekty politiky pre nájomcu prihláseného správcu.

Poznámka

• Keď zobrazíte politiku údajov pomocou prostredia PowerShell, zobrazovaný názov konektorov pochádza z času, keď bola vytvorená politika údajov alebo kedy boli konektory naposledy presunuté v rámci politiky. Nové zmeny zobrazovaných názvov konektorov sa neprejavia.
• Keď zobrazíte politiku údajov pomocou prostredia PowerShell, nové konektory v predvolenej skupine, ktoré sa nepremieňali, sa nevrátia.

Pre oba tieto známe problémy je riešením presunúť dotknutý konektor do inej skupiny v rámci politiky a potom ho presunúť späť do správnej skupiny. Po vykonaní tohto kroku sa každý z konektorov zobrazuje so správnym názvom.

Aktualizácia politiky používania údajov

Set-DlpPolicy

Aktualizuje podrobnosti o politike, napríklad zobrazovaný názov politiky.

Odstrániť politiku

Remove-DlpPolicy

Odstráni politiku používania údajov.

Rutiny typu cmdlet na oslobodenie zdrojov údajov

Tieto rutiny typu cmdlet umožňujú oslobodiť alebo zrušiť odstránenie konkrétneho zdroja z politiky.

Načítanie existujúceho zoznamu zdrojov vyňatia pre politiku údajov

Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Vytvorenie nového zoznamu zdrojov vyňatia pre politiku údajov

New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources 

Aktualizácia zoznamu vyňatých zdrojov pre politiku údajov

Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources 

Odstránenie zoznamu zdrojov vyňatia pre politiku údajov

Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Ak chcete vyňať zdroj z politiky používania údajov, musíte mať tieto informácie:

• ID nájomníka (GUID)
• ID politiky používania údajov (GUID)
• ID zdroja (končí sa identifikátorom GUID)
• Typ zdroja

ID prostriedku a typ môžete načítať pomocou rutín PowerShell Get-PowerApp pre aplikácie a Get-Flow pre toky.

Príklad skriptu na odstránenie

Ak chcete vyňať tok s ID f239652e-dd38-4826-a1de-90a2aea584d9 a aplikáciou s ID 06002625-7154-4417-996e-21d7a60ad624, môžeme spustiť nasledujúce rutiny 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.. 

Oslobodenie od politiky používania údajov v nasledujúcich scenároch

#	Scenár	Prostredie
1	Používateľ spustí aplikáciu, ktorá nie je v súlade s politikou údajov, ale vyňať z politiky údajov.	Spustenie aplikácie pokračuje s vynútením politiky používania údajov alebo bez ňou.
2	Tvorca uloží aplikáciu, ktorá nie je v súlade s politikou údajov, ale vyníma politiku používania údajov	S výnimkou politiky používania údajov alebo bez tejto výnimky nie je súlad s politikou údajov blokovaný operáciu ukladania aplikácie. Upozornenie týkajúce sa nedodržania politiky používania údajov sa uvádza bez ohľadu na výnimku politiky používania údajov.
3	Tvorca uloží postup, ktorý nie je v súlade s politikou údajov, ale vyníma politiku používania údajov	S výnimkou politiky používania údajov alebo bez tejto výnimky už zabezpečenie súladu s politikou údajov neblokuje operáciu ukladania postupu. Upozornenie o nesúlade s politikou údajov sa nezobrazí.

Príkazy obsahu chybovej správy riadenia

Nasledujúce rutiny cmdlet môžu viesť vašich koncových používateľov k referenčnému materiálu o riadení vašej organizácie. Príkaz obsahuje prepojenie na dokumentáciu o riadení a kontakt na riadenie, keď sú vyzvaní ovládacími prvkami riadenia. Keď je napríklad nastavený obsah chybového hlásenia o riadení, zobrazí sa v správach o spustení politiky používania údajov v službe Power Apps údajov.

Nastavenie obsahu chybovej správy riadenia

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

URL a e-mail s chybovou správou riadenia sa môžu zobrazovať nezávisle alebo spoločne. Chybové hlásenie o riadení môžete povoliť alebo zakázať pomocou poľa enabled .

Scenáre obsahu chybových správ riadenia

#	Scenár	Dostupnosť
1	Používateľ spustí aplikáciu vytvorenú pomocou Power Apps, ktorá nie je v súlade s politikou údajov	Všeobecne dostupné
2	Tvorca zdieľa Power Apps aplikáciu plátna, ale nemá oprávnenie na zdieľanie	Všeobecne dostupné
3	Tvorca zdieľa Power Apps aplikáciu plátna s Everyone ale nemá oprávnenie zdieľať s Everyone	Všeobecne dostupné
4	Tvorca uloží aplikáciu vytvorenú pomocou Power Apps, ktorá nie je v súlade s politikou údajov	Všeobecne dostupné
5	Tvorca uloží Power Automate postupu, ktorý nie je v súlade s politikou údajov	Všeobecne dostupné
6	Používateľ spustí aplikáciu bez členstva v bezpečnostnej skupine v bezpečnostnej skupine priradenej k Dataverse prostrediu	Všeobecne dostupné

Zobrazenie obsahu chybovej správy riadenia

Get-PowerAppDlpErrorSettings -TenantId 'TenantId' 

Aktualizácia obsahu chybovej správy riadenia

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

Vynútenie politiky údajov pre porušenie pripojení – prostredie

Tieto rutiny typu cmdlet umožňujú vynútiť politiku údajov za porušenie pripojení na úrovni prostredia alebo nájomníka.

Vynútenie politík používania údajov za porušenie pripojení

Politiky používania údajov môžete vynucovať pri pripojeniach v prostredí. Vynucovanie zakáže existujúce pripojenia porušujúce politiky používania údajov a povolí všetky predtým zakázané pripojenia, ktoré už neporušujú politiky používania údajov.

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName [Environment ID]

Príklad skriptu na vynútenie prostredia

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

Vynútenie politík používania údajov za porušenie pripojení – nájomník

Politiky používania údajov môžete vynútiť pri pripojeniach v nájomníkovi. Vynucovanie zakáže existujúce pripojenia porušujúce politiky používania údajov a povolí všetky predtým zakázané pripojenia, ktoré už neporušujú politiky používania údajov.

Start-DLPEnforcementOnConnectionsInTenant

Blokovať príkazy skúšobných licencií

Príkazy:

Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans

Rutiny cmdlets povolených plánov súhlasu môžu byť použité na pridanie alebo odstránenie prístupu k určitému typu plánu súhlasu od nájomníka. Plány interných súhlasov sú skúšobné licencie alebo plány pre vývojárov, do ktorých sa používatelia môžu zaregistrovať prostredníctvom portálov alebo portálov Power Apps/Power Automate alebo Power Automate pre pracovnú plochu. Plány súhlasu „Ad-hoc“ alebo „Vírusové“ sú skúšobné licencie, na odber ktorých sa môžu používatelia sami zaregistrovať na adrese https://signup.microsoft.com. Správcovia môžu priradiť používateľov prostredníctvom Microsoft Entra ID alebo portálu na správu Microsoft 365.

Všetky typy plánov súhlasu sú v nájomníkovi predvolene povolené. Správca Power Platformy však možno bude chcieť zablokovať používateľom, aby si priradili skúšobné licencie, ale zachovať si možnosť priraďovať skúšobné licencie v mene používateľov. Toto pravidlo možno vykonať pomocou príkazu Remove-AllowedConsentPlans -Types "Internal" a nepovolením nastavenia Update-MgPolicyAuthorizationPolicy -AllowedToSignUpEmailBasedSubscriptions v Microsoft Entra ID.

Ak máte otázky

Ak máte pripomienky, návrhy alebo otázky, uverejnite ich na paneli Správa Power Apps paneli komunity.

Súvisiace informácie

• Získať pomocou modulu správcu Power Apps.
  
• Microsoft.PowerApps.Správa.PowerShell
  
• verzia Preview: Prehľad programovateľnosti a rozšíriteľnosti