Deli z drugimi prek


Podpora za PowerShell za Power Apps in Power Automate

Z PowerShell cmdlet-i za Power Platform ustvarjalce in skrbnike lahko avtomatizirate številne naloge spremljanja in upravljanja. Opravila, ki so mogoča le manually danes v Power Apps, Power Automate ali Power Platform admin center.

Ukazi »cmdlet«

Cmdleti so funkcije, napisane v PowerShell skriptnem jeziku, ki izvajajo ukaze v PowerShell. Zagon teh Power Apps »cmdlet« vam omogoča interakcijo s platformo za poslovne aplikacije, ne da bi morali brskati po skrbniškem portalu v spletnem brskalniku.

Cmdlete lahko kombinirate z drugimi funkcijami PowerShell, da napišete zapletene skripte, ki lahko optimizirajo vaš potek dela. Še vedno lahko uporabljate cmdlete, če niste skrbnik najemnika, vendar ste omejeni na vire, ki jih imate. Administrativni uporabniški račun uporablja cmdlete, ki se začnejo z Admin.

Ukazi »cmdlet« so na voljo v galeriji PowerShell kot dva ločena modula:

Če želite informacije o skrbniškem modulu za Power Apps, glejte Udobite uporabo skrbniškega modula za Power Apps in Microsoft.PowerApps.Administration.PowerShell.

Začnite z PowerShell

Če še niste uporabljali PowerShell in potrebujete pomoč pri iskanju in zagonu, pojdite na Kako začeti z PowerShell. Če potrebujete pomoč pri uporabi PowerShell ali cmdletov, pojdite na Sistem pomoči PowerShell.

Zahteve za PowerShell

PowerShell v tem članku zahteva Windows PowerShell različica 5.x. Če želite preveriti različico storitve PowerShell, ki se izvaja v vašem računalniku, zaženite naslednji ukaz:

$PSVersionTable.PSVersion

Če imate zastarelo različico, pojdite na Nagradnja obstoječe Windows PowerShell.

Pomembno

Moduli, opisani v tem dokumentu, uporabljajo ogrodje .NET, ki ni združljivo z ogrodjem PowerShell 6.0 in novejšimi različicami. Te novejše različice uporabljajo .NET Core.

Namestitev modula in prijava

Če želite zagnati ukaze PowerShell za ustvarjalce aplikacij:

  1. Zaženite lupino PowerShell kot skrbnik.

    Posnetek zaslona, ​​ki prikazuje, kako zagnati PowerShell kot skrbnik.

  2. Uvozite potrebne module.

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

    Druga možnost je, da za namestitev uporabite parameter -Scope CurrentUser , če v svojem računalniku nimate skrbniških pravic.

    Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -Scope CurrentUser
    Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber -Scope CurrentUser
    
  3. Če ste pozvani, da sprejmete spremembo InstallationPolicy vrednosti repozitorija, sprejmite [A] Yes za vse module tako, da vnesete A, nato pritisnite Enter za vsak modul.

    Posnetek zaslona, ​​ki prikazuje, kje sprejeti vrednost InstallationPolicy v PowerShell.

  4. Po želji lahko pred dostopom do ukazov vnesete svoje poverilnice. Poverilnice se osvežujejo do osem ur, preden se morate znova prijaviti. Če poverilnice niso posredovane pred izvedbo ukaza, se prikaže poziv za poverilnice.

    # 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. Po želji je mogoče ciljati na določen končna točka. Privzeti končna točka je prod. Če želi uporabnik zagnati skript ogrodja PowerShell, ki ima za cilj okolje v neproizvodni regiji, kot je GCC, -Endpoint lahko parameter usgov spremenite v za GCC Moderate ali usgovhigh GCC High ali dod za GCC DOD. Celoten seznam podprtih končnih točk je: "prod,predogledna različica,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" 
    

Posodobitve modulov

Različico vseh svojih PowerShell modulov lahko preverite z Get-Module.

Get-Module

Vse svoje module PowerShell lahko posodobite na najnovejše z Update-Module.

Update-Module

Druga možnost je, da preverite različico Power Platform modulov z uporabo Get-Module in parametra -Name .

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

Posodobite module Power Platform PowerShell z uporabo Update-Module in parametra -Name .

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

Power Apps ukazi »cmdlet« za ustvarjalce aplikacij

Zahteve za Power Apps »cmdlet«

Uporabniki z veljavno licenco Power Apps lahko izvajajo operacije v teh ukazih »cmdlet«. Vendar pa imajo dostop samo do virov, kot so aplikacije in tokovi, ki so ustvarjeni ali v skupni rabi z njimi.

Seznam ukazov »cmdlet« – ukazi »cmdlet« za ustvarjalce

opomba,

Posodobili smo nekaj imen funkcij »cmdlets« v najnovejši izdaji, da smo dodali ustrezne predpone za preprečevanje težav. Če želite pregled nad tem, kaj se je spremenilo, si oglejte to tabelo.

Namen Ukaz »cmdlet«
Dodajanje programa platno v Microsoft Dataverse rešitev Set-PowerAppAsSolutionAware
Branje in posodobitev okolij Get-AdminPowerAppEnvironment(prej Get-PowerAppsEnvironment)
Get-FlowEnvironment
Restore-PowerAppEnvironment(prej Restore-AppVersion)
Branje, posodobitev in brisanje aplikacije s platnom Get-AdminPowerApp(prej Get-App)
Remove-AdminPowerApp(prej Remove-App)
Publish-AdminPowerApp (predhodno Publish-App)
Branje, posodobitev in brisanje dovoljenj za aplikacije s platnom Get-AdminPowerAppRoleAssignment(prej Get-AppRoleAssignment)
Remove-AdminPowerAppRoleAssignment(prej Remove-AppRoleAssignment)
Branje, posodobitev in brisanje poteka Get-AdminFlow
Omogoči-AdminFlow
Onemogoči-AdminFlow
Odstrani-AdminFlow
Branje, posodobitev in brisanje dovoljenj za poteke Get-AdminFlowOwnerRole
Set-AdminFlowOwnerRole
Odstrani-AdminFlowOwnerRole
Branje in odziv na odobritve potekov Get-AdminFlowApprovalRequest
Odstrani-AdminFlowApprovals
Branje in brisanje povezav Get-AdminPowerAppConnection(prej Get-Connection)
Remove-AdminPowerAppConnection(prej Remove-Connection)
Branje, posodobitev in brisanje dovoljenj za povezave Get-AdminPowerAppConnectionRoleAssignment(prej Get-ConnectionRoleAssignment)
Set-AdminPowerAppConnectionRoleAssignment(prej Set-ConnectionRoleAssignment)
Remove-AdminPowerAppConnectionRoleAssignment(prej Remove-ConnectionRoleAssignment)
Branje in brisanje povezovalnikov Get-AdminPowerAppConnector(prej Get-Connector)
Remove-AdminPowerAppConnector(prej Remove-Connector)
Dodajanje, branje, posodabljanje in brisanje dovoljenj za povezovalnike po meri Get-AdminPowerAppConnectorRoleAssignment(prej Get-ConnectorRoleAssignment)
Get-PowerAppConnectorRoleAssignment(prej Set-ConnectorRoleAssignment)
Remove-PowerAppConnectorRoleAssignment(prej Remove-ConnectorRoleAssignment)
Branje, dodajanje in odstranjevanje vzorcev URL-ja pravilnika Get-PowerAppPolicyUrlPatterns
New-PowerAppPolicyUrlPatterns
Remove-PowerAppPolicyUrlPatterns
Branje, registriranje in odstranjevanje aplikacij za upravljanje Get-PowerAppManagementApp
Get-PowerAppManagementApps
New-PowerAppManagementApp
Remove-PowerAppManagementApp
Branje, ustvarjanje, posodobitev in uvoz ključev za zaščito Get-PowerAppRetrieveAvailableTenantProtectionKeys
Get-PowerAppGenerateProtectionKey
Get-PowerAppRetrieveTenantProtectionKey
New-PowerAppImportProtectionKey
Set-PowerAppTenantProtectionKey

Power Apps »cmdlet« za skrbnike

Če želite več informacij o ukazih »cmdlet« za Power Apps in Power Automate za skrbnike, glejte U začetku uporabe lupine PowerShell za skrbnike platforme Power.

Namigi

  • Uporabite Get-Help ki mu sledi a CmdletName , da dobite seznam primerov.

    Posnetek zaslona, ​​ki prikazuje uporabo ukaza Get-Help.

  • Ko vnesete pomišljaj -, lahko pritisnete Tab za kroženje med vnosnimi oznakami. To zastavico postavite za imenom cmdleta.

Primeri ukazov:

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

Primeri postopkov

V nadaljevanju je navedenih nekaj pogostih scenarijev, ki prikazujejo, kako uporabljati nove in Power Apps ukaze »cmdlet«.

Ukazi v okolju

Uporabite te ukaze za pridobivanje podrobnosti o okoljih in jih posodobite v najemniku.

Prikaz seznama vseh okolij

Get-AdminPowerAppEnvironment

Vrne seznam vsakega okolja v vašem najemniku s podrobnostmi o vsakem (na primer ime okolja (GUID), prikazno ime, lokacija, ustvarjalec in drugo).

Prikaz podrobnosti vašega privzetega okolja

Get-AdminPowerAppEnvironment –Default

Vrne podrobnosti samo za privzeto okolje najemnika.

Prikaz podrobnosti določenega okolja

Get-AdminPowerAppEnvironment –EnvironmentName 'EnvironmentName'

opomba,

Polje EnvironmentName je edinstven identifikator, ki se razlikuje od DisplayName (glejte prvo in drugo polje v izpis na naslednji sliki).

Ukaz Get-AdminEnvironment.

Power Apps ukazi

Ti postopki se uporabljajo za branje in spreminjanje Power Apps podatkov v vašem najemniku.

Prikaz seznama vseh Power Apps

Get-AdminPowerApp

Vrne seznam vseh elementov Power Apps v najemniku s podrobnostmi vsakega uporabnika (na primer ime programa (GUID), prikazano ime, avtor in drugo).

Prikaz seznama vseh elementov Power Apps ki se ujemajo s prikazanim imenom vnosa

Get-AdminPowerApp 'DisplayName'

V tem ukazu so navedeni vsi Power Apps v najemniku, ki se ujemajo s prikazanim imenom.

opomba,

Okoli vhodnih vrednosti, ki vsebujejo presledke, uporabite narekovaje. Uporabite na primer »Ime moje aplikacije«.

Predstavitev aplikacije

Set-AdminPowerAppAsFeatured –AppName 'AppName'

Predstavljene aplikacije so združene in potisnjene na vrh seznama v Power Apps mobilni predvajalnik.

opomba,

Tako kot okolja je polje AppName enolični identifikator, ki se razlikuje od DisplayName. Če želite izvajati postopke, ki temeljijo na prikaznem imenu, vam bodo nekatere funkcije omogočile uporabo cevovoda (glejte naslednjo funkcijo).

Aplikacijo s cevovodom naredite v glavno aplikacijo

Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero

Aplikacija Hero se prikaže na vrhu seznama v aplikaciji Power Apps mobilnim predvajalnikom. Obstaja lahko le ena glavna aplikacija.

Znak cevi | med dvema ukazoma cmdlet vzame izhod prvega ukaza cmdlet in ga posreduje kot vhodno vrednost drugega, če je funkcija napisana tako, da sprejme cev.

opomba,

Aplikacija mora že biti predstavljena aplikacija, preden jo spremenite v Hero.

Prikaz števila aplikacij, ki jih imajo posamezni uporabniki

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

Izvorne funkcije ogrodja PowerShell lahko združite s Power Apps ukazi »cmdlet« za dodatno spreminjanje podatkov. Tu uporabljamo funkcijo Izbira, da izoliramo atribut Lastnik (predmet) od predmeta Get-AdminApp. Nato izoliramo ime predmeta lastnika tako, da izhodno vrednost izpeljemo v drugo funkcijo Izbira. Na koncu s prenosom druge izhodne vrednosti funkcije Izbira v funkcijo Skupina pridobimo tabelo, ki vključuje število aplikacij vsakega lastnika.

Ukaz Get-AdminPowerApp.

Prikaz števila aplikacij v posameznih okoljih

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

Okolje Get-AdminPowerApp.

Prenesite Power Apps o uporabniku

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

Prejšnji ukaz shrani podrobnosti Power Apps uporabnika (osnovne informacije o uporabi vhodnega uporabnika prek glavnega imena uporabnika) v določeno besedilno datoteko. Ustvari novo datoteko, če ni obstoječe datoteke s tem imenom, in prepiše besedilno datoteko, če že obstaja.

Izvoz seznama dodeljenih uporabniških licenc

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

Izvozi vse dodeljene uporabniške licence (Power Apps in Power Automate) v tabelarični pogled .csv datoteko. Izvožena datoteka vsebuje samopostrežne pakete za prijavo, notranje preskusne pakete in pakete, ki so bili dostavljeni Microsoft Entra ID. Notranji paketi preskusov niso vidni skrbnikom v skrbniškem središču za Microsoft 365.

Izvoz lahko traja nekaj časa za najemnike z velikim številom uporabnikov Microsoft Power Platform uporabniki.

opomba,

Izhod ukaza »cmdlet« Get-AdminPowerAppLicenses vključuje le licence za uporabnike, ki so dostopali do storitev Power Platform (na primer Power Apps, Power Automate ali Skrbniško središče za Power Platform). Uporabniki, ki so imeli licence, dodeljene v storitvi Microsoft Entra ID (običajno prek skrbniškega središča za Microsoft 365), vendar niso dostopali do storitev Power Platform, nimajo licenc, vključenih v ustvarjeni .csv izhod. Ker storitve licenciranja platforme Power Predpomnijo licence, lahko posodobitve dodelitev licenc v storitvi Microsoft Entra ID trajajo do sedem dni, da se odražajo v rezultatu za uporabnike, ki nedavno niso dostopali do storitve.

Nastavitev prijavljenega uporabnika kot lastnika aplikacije s platnom

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

Spremeni vlogo lastnika Power App v trenutnega uporabnika in zamenja prvotnega lastnika kot vrsto vloge »lahko si ogleda«.

opomba,

Polji AppName in EnvironmentName sta edinstvena identifikatorja (vodnika), ne prikazna imena.

Prikaz seznama izbrisanih aplikacij s platnom v določenem okolju

Get-AdminDeletedPowerAppsList -EnvironmentName 'EnvironmentName'

Ta ukaz prikaže vse nedavno izbrisane aplikacije platna, saj jih je mogoče še obnoviti. Trajanje vnovičnega shranjevanja je 28 dni. Program, ki ste ga izbrisali po 28 dneh, ni vrnjen na tem seznamu in ga ni mogoče obnoviti.

Obnova izbrisane aplikacije s platnom

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

Ta ukaz obnovi aplikacijo platna, ki jo je mogoče odkriti prek ukaza Get-AdminDeletedPowerAppsList cmdlet. Nobene aplikacije platna, ki ni prikazana v Get-AdminDeletedPowerAppsList ni mogoče obnoviti.

Določanje SharePoint obrazca po meri

S temi ukazi »cmdlet« lahko določite in preverite, v katero SharePoint so shranjeni obrazci po meri, namesto privzetega okolja. Ko se določeno okolje za obrazce SharePoint spremeni, se v tem okolju shranjujejo novo ustvarjeni obrazci po meri. Obstoječi obrazci po meri se samodejno ne prenesejo v različna okolja, saj se uporabljajo ti ukazi »cmdlet«. Sposobnost uporabnika, da ustvari obrazec po meri v določenem okolju, zahteva, da ima uporabnik vlogo ustvarjalca okolja. Uporabniki lahko prejmejo vlogo ustvarjalca okolja v skrbniškem središču za Power Platform.

Vsako okolje, ki ni privzeto okolje, je mogoče izbrisati. Če je določeno SharePoint obrazca po meri izbrisano, so obrazci po meri izbrisani z njim.

Get-AdminPowerAppSharepointFormEnvironment  

Ta ukaz vrne EnvironmentName za okolje, ki je trenutno določeno za novo ustvarjene SharePoint obrazce po meri. Če okolje ni bilo nikoli določeno, se vrne privzeto okolje.

Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName' 

S tem ukazom določite okolje, v SharePoint shranjevalne obrazce po meri, namesto privzetega okolja. Obstoječi obrazci po meri se ne prenesejo samodejno v na novo določeno okolje. Za obrazce po meri je mogoče SharePoint samo proizvodno okolje.

Reset-AdminPowerAppSharepointFormEnvironment  

S tem ponastavite privzeto okolje kot določeno okolje za shranjevanje SharePoint obrazcev po meri.

Prikaži nastavitev najemnika za možnost deljenja aplikacij z Vsi

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

Ta nastavitev nadzira, ali lahko uporabniki z ustvarjalec okolja varnostna vloga delijo aplikacije platna z vsemi v organizaciji. Ko je nastavitev nastavljena na true, lahko aplikacije delijo le uporabniki z vlogo skrbnika (skrbnik Dynamics 365, skrbnik storitve Power Platform Microsoft Entra skrbnik najemnika) v skupno rabo z Vse v organizaciji.

Ne glede na to vrednost nastavitev najemnika lahko izdelovalci s privilegijem skupne rabe delijo aplikacije z varnostnimi skupinami poljubne velikosti. Ta kontrolnik samo določa, ali je pri skupni rabi mogoče uporabiti kratico Vsi .

Spremenite nastavitev najemnika za možnost skupne rabe aplikacij z Vsi

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

Surface sporočila o napakah upravljanja organizacije

Če določite, da se vsebina sporočila o napaki upravljanja prikaže v sporočilih o napakah, se vsebina v sporočilu o napaki prikaže, ko izdelovalci opazijo, da nimajo dovoljenja za skupno rabo aplikacij z Vsi. Glejte Ukazi vsebine sporočila o napaki upravljanja PowerShell.

Povezovanje v kontekstnih tokovih aplikacije

Povežite tokove v kontekstu aplikacije s to aplikacijo, da ustvarite odvisnost med aplikacijo in tokovi. Če želite izvedeti več o potekih konteksta, glejte Kaj zmogljivosti Power Automate so vključene v licence za Power Apps?

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

EnvironmentName in FlowName lahko najdete v URL-ju toka:

  • Za tok brez rešitve je URL videti takole:

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

    GUID after environments/ je EnvironmentName in GUID after flows/ je FlowName

  • Za tok rešitve je URL videti takole:

    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 after environments/ je EnvironmentName in GUID after flows/ je FlowName

  • AppName za aplikacijo Canvas je na voljo na strani s podrobnostmi o aplikaciji Canvas.

    Posnetek zaslona, ​​ki prikazuje, da je AppName za aplikacijo platna mogoče najti na strani s podrobnostmi o aplikaciji platna.

  • Ime aplikacije za aplikacijo, ki temelji na modelu, je mogoče najti v raziskovalcu rešitev.

    Posnetek zaslona, ​​ki prikazuje, da je AppName za aplikacijo, ki temelji na modelu, mogoče najti v raziskovalcu rešitev.

  • Če si želite ogledati primere, vnesite: get-help Add-AdminFlowPowerAppContext -examples.

  • Za več informacij vnesite: get-help Add-AdminFlowPowerAppContext -detailed.

  • Za tehnične informacije vnesite: get-help Add-AdminFlowPowerAppContext -full.

Odstranjevanje v kontekstnih tokovih aplikacije

Odstranite odvisnost med tokovi in aplikacijo s tem ukazom PowerShell. Ukaz Remove-AdminFlowPowerAppContext odstrani kontekst aplikacije iz določenega toka.

    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 ukazi

Uporabite te pomembne ukaze za izvajanje skrbništva, povezanega z Power Automate.

Celoten seznam ukazov »cmdlet« za Power Automate in Power Apps za skrbnike najdete v članku U začetku uporabe lupine PowerShell za skrbnike platforme Power.

Prikaz vseh potekov

Get-AdminFlow

Vrne seznam vseh potekov v najemniku.

Prikaz podrobnosti o vlogi lastnika poteka

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

Vrne podrobnosti o lastniku določenega poteka.

opomba,

Tako kot Okolja in PowerApps je FlowName enolični identifikator (GUID), ki se razlikuje od prikazno ime toka.

Prikaz podrobnosti o uporabniku poteka

Get-AdminFlowUserDetails –UserId $Global:currentSession.userId

Vrne podrobnosti o uporabniku glede uporabe poteka. V tem primeru kot vhod uporabljamo ID uporabnika trenutno prijavljenega uporabnika seje PowerShell.

Odstranjevanje podrobnosti o uporabniku poteka

Remove-AdminFlowUserDetails –UserId 'UserId'

Iz Microsoftove zbirke podatkov v celoti izbriše podrobnosti o uporabniku poteka. Preden lahko izbrišete podrobnosti o uporabniku poteka, morate izbrisati vse poteke, ki jih ima v lasti vhodni uporabnik.

opomba,

Polje UserId je ID predmeta zapisa Microsoft Entra uporabnika, ki ga najdete v portalu Azure portal v razdelku Microsoft Entra ID>ProfileOBJECT ID. Za dostop do teh podatkov od tukaj morate biti skrbnik.

Izvoz vseh potekov v datoteko CSV

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

Izvozi vse poteke v najemnika v datoteko .csv s tabelarnim prikazom.

Dodajte tokove v Dataverse rešitve

Add-AdminFlowsToSolution -EnvironmentName <String>

Preseli vse tokove brez rešitve v okolju.

Različice parametrov je mogoče uporabiti za selitev samo določenih tokov, dodajanje v specifično rešitev ali selitev samo določenega števila tokov hkrati.

Za tehnične podrobnosti glejte Add-AdminFlowsToSolution.

Seznam potekov dejanj HTTP

Get-AdminFlowWithHttpAction -EnvironmentName <String>

Seznami se pretakajo z dejanji HTTP.

Prikazno ime Ime poteka Ime okolja
Pridobi račun HTTP flow-1 okolje -1
Plačilo računa iz programa flow-2 okolje -2
Račun Reconcile flow-3 okolje -3

Ukazi za povezavo API-ja

Prikaže in upravlja povezave API-ja v najemniku.

Prikaz vseh izvornih povezav v privzetem okolju

Get-AdminPowerAppEnvironment -Default | Get-AdminPowerAppConnection

Prikaže seznam vseh povezav API-ja, ki jih imate v privzetem okolju. Izvorne povezave najdete pod zavihkom Dataverse>Connections v Power Apps.

Prikaz vseh povezovalnikov po meri v najemniku

Get-AdminPowerAppConnector

Vrne seznam vseh podrobnosti o povezovalniku po meri v najemniku.

opomba,

Get-AdminPowerAppConnector ne navaja priključkov po meri, ki so v rešitvi. To je znana omejitev.

Ukazi pravilnika podatkov

Ti ukazi »cmdlet« nadzirajo pravilnike podatkov v vašem najemniku.

Ustvarjanje pravilnika o podatkih

New-DlpPolicy

Ustvari nov pravilnik o podatkih za najemnika vpisanega skrbnika.

Pridobivanje seznama predmetov pravilnika podatkov

Get-DlpPolicy

Pridobi predmete pravilnika za najemnika vpisanega skrbnika.

opomba,

  • Ko si pravilnik o podatkih ogledate s storitvijo PowerShell, je prikazano ime povezovalnikov od takrat, ko je bil ustvarjen pravilnik o podatkih ali ko so bili povezovalniki nazadnje premaknjeni v pravilniku. Nove spremembe prikazanih imen povezovalnikov niso vidne.
  • Ko si s storitvijo PowerShell ogledate pravilnik o podatkih, novi povezovalniki v privzeti skupini, ki niso bili premaknjeni, niso vrnjeni.

Za obe znani težavi je rešitev, da prizadeti konektor premaknete v drugo skupino znotraj pravilnika in ga nato premaknete nazaj v pravilno skupino. Ko to naredite, je vsak povezovalnik viden s pravilnim imenom.

Posodobitev pravilnika o podatkih

Set-DlpPolicy

Posodobi podrobnosti o pravilniku, na primer prikazno ime pravilnika.

Odstranjevanje pravilnika

Remove-DlpPolicy

Izbriše pravilnik o podatkih.

Ukazi »cmdlet« za izvzetje vira podatkov

S temi ukazi »cmdlet« lahko iz pravilnika izvzamete ali odstranite določen vir.

Pridobivanje obstoječega izvzetega seznama virov za pravilnik podatkov

Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Ustvarjanje novega seznama izvzetih virov za pravilnik o podatkih

New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources 

Posodobitev seznama izvzetih virov za pravilnik o podatkih

Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources 

Odstranjevanje seznama izvzetih virov za pravilnik o podatkih

Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Če želite izvzeti vir iz pravilnika za podatke, potrebujete te informacije:

  • ID najemnika (GUID)
  • ID pravilnika podatkov (GUID)
  • ID vira (konča se z GUID)
  • Vrsta vira

ID in tip vira lahko pridobite s pomočjo ukazov »cmdlets« storitve PowerShell Get-PowerApp za aplikacije in storitve Get-Flow za tokove.

Primer skripte za odstranitev

Če želite izvzeti tok z ID-jem f239652e-dd38-4826-a1de-90a2aea584d9 in aplikacijo z ID-jem 06002625-7154-4417-996e-21d7a60ad624, lahko zaženemo naslednje cmdlete:

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

Izkušnja izjeme pravilnika o podatkih v teh scenarijih

# Scenarij Izkušnja
1 Uporabnik zažene aplikacijo, ki ni skladna s pravilnikom o podatkih, vendar je pravilnik o podatkih izvzet. Zagon programa se nadaljuje z uveljavljanjem pravilnika o podatkih ali brez tega.
2 Maker shrani aplikacijo, ki ni skladna s pravilnikom o podatkih, vendar je pravilnik o podatkih izvzet Če je pravilnik o podatkih izvzet ali brez, skladnost pravilnika podatkov ne blokira postopka shranjevanja aplikacije. Opozorilo o neskladnosti pravilnika o podatkih je prikazano ne glede na izjemo pravilnika o podatkih.
3 Maker shrani tok, ki ni skladen s pravilnikom o podatkih, vendar je pravilnik o podatkih izvzet Če je pravilnik o podatkih izvzet ali brez, skladnost pravilnika podatkov ne blokira postopka shranjevanja poteka. Opozorilo o nesmislnosti pravilnika o podatkih se ne prikaže.

Ukazi vsebine sporočila o napaki upravljanja

Naslednji cmdleti lahko pripeljejo vaše končne uporabnike do referenčnega gradiva o upravljanju vaše organizacije. Ukaz vključuje povezavo do dokumentacije o upravljanju in kontakt za upravljanje, ko jih pozovejo kontrolniki upravljanja. Ko je na primer nastavljena vsebina sporočila o napakah upravljanja, je prikazana v Power Apps pravilnika o izvajanju podatkov.

Nastavitev vsebine sporočila o napaki upravljanja

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

URL sporočila o napaki upravljanja in e-pošta sta lahko prikazana neodvisno ali skupaj. Sporočilo o napaki upravljanja lahko omogočite ali onemogočite s poljem enabled .

Scenariji vsebine sporočila o napaki upravljanja

# Scenarij Razpoložljivost
1 Uporabnik zažene aplikacijo, ustvarjeno s Power Apps ki ni skladna s pravilnikom o podatkih Splošno na voljo
2 Maker da v skupno rabo Power Apps platno, vendar nima pravic za skupno rabo Splošno na voljo
3 Maker da aplikacijo Power Apps platno v skupno rabo s programom Everyone vendar nima pravice za skupno rabo s storitvijo Everyone Splošno na voljo
4 Maker shrani program, ustvarjen s Power Apps, ki ni skladna s pravilnikom o podatkih Splošno na voljo
5 Maker shrani tok Power Automate ki ni skladen s pravilnikom o podatkih Splošno na voljo
6 Uporabnik zažene aplikacijo brez članstva v varnostni skupini v varnostni skupini, povezani z Dataverse okoljem Splošno na voljo

Prikaz vsebine sporočila o napaki upravljanja

Get-PowerAppDlpErrorSettings -TenantId 'TenantId' 

Posodobitev vsebine sporočila o napaki upravljanja

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

Vsili pravilnik podatkov za kršitve povezav – okolje

S temi ukazi »cmdlet« lahko uveljavite pravilnik o podatkih za kršitve povezav na ravni okolja ali najemnika.

Vsili pravilnike podatkov za kršitve povezav

Uveljavite lahko pravilnike o podatkih za povezave v okolju. Z uveljavljanjem onemogočite obstoječe povezave, ki kršijo podatkovne pravilnike, in omogočite vse prej onemogočene povezave, ki ne kršijo več pravilnikov o podatkih.

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName [Environment ID]
Primer skripta za uveljavljanje okolja
Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName c4a07cd6-cb14-e987-b5a2-a1dd61346963 

Vsili pravilnike podatkov za kršitve povezav – najemnik

Uveljavite lahko pravilnike podatkov za povezave v najemniku. Z uveljavljanjem onemogočite obstoječe povezave, ki kršijo podatkovne pravilnike, in omogočite vse prej onemogočene povezave, ki ne kršijo več pravilnikov o podatkih.

Start-DLPEnforcementOnConnectionsInTenant

Blokiranje ukazov licenc za preskusne različice

Ukazi:

Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans

Ukazi »cmdlet« dovoljenih paketov s soglasjem se lahko uporabljajo za dodajanje ali odstranjevanje dostopa do določene vrste paketa s soglasjem najemnika. »Notranji« paketi soglasja so preskusne licence ali paketi za razvijalce, na katere se lahko uporabniki prijavijo prek portalov Power Apps/Power Automate/Power Automate za namizne računalnike. Načrti soglasja »Ad-hoc naročnina« ali »Viral« so preskusne licence, za katere se lahko uporabniki sami prijavijo na https://signup.microsoft.com. Skrbniki lahko dodelijo uporabnike prek Microsoft Entra ID ali skrbniškega Microsoft 365 skrbnika.

V najemniku so privzeto dovoljene vse vrste paketov soglasja. Vendar pa bo skrbnik platforme Power Platform morda hotel uporabnikom blokirati dodeljevanje preskusnih licenc, vendar ohrani možnost dodeljevanja preskusnih licenc v imenu uporabnikov. To pravilo lahko izvedete z ukazom Remove-AllowedConsentPlans -Types "Internal" in ne omogočite nastavitve Update-MgPolicyAuthorizationPolicy -AllowedToSignUpEmailBasedSubscriptions v Microsoft Entra ID.

Če imate vprašanja

Če imate pripombe, predloge ali vprašanja, jih objavite na Administering Power Apps community board.