Megosztás:


PowerShell és támogatása Power Apps Power Automate

A létrehozóknak és rendszergazdáknak szóló PowerShell Power Platform parancsmagokkal számos figyelési és felügyeleti feladatot automatizálhat. Olyan feladatok, amelyek jelenleg csak manuálisan lehetségesek a felügyeleti központban . Power AppsPower AutomatePower Platform

Parancsmagok

A parancsmagok a PowerShell szkriptnyelven írt függvények , amelyek PowerShell parancsokat hajtanak végre. Ezeknek a parancsmagoknak a Power Apps futtatása lehetővé teszi, hogy anélkül kommunikáljon az üzletialkalmazás-platformmal, hogy végig kellene mennie a felügyeleti portálon egy webböngészőben.

A parancsmagokat más PowerShell függvényekkel kombinálva összetett szkripteket írhat, amelyek optimalizálhatják a munkafolyamatot. A parancsmagokat akkor is használhatja, ha nem rendszergazda a bérlőn, de a tulajdonában lévő erőforrásokra korlátozódik. A rendszergazdai felhasználói fiók a következővel Admin kezdődő parancsmagokat használja: .

A parancsmagok két különálló modulként érhetők el a PowerShell galériában:

További információ a Power Apps felügyeleti moduljáról: A Power Apps-felügyeleti modul használatának első lépései és Microsoft.PowerApps.Administration.PowerShell.

Első lépések a PowerShell használatával

Ha még nem ismeri a PowerShell funkciót, és segítségre van szüksége a megtalálásához és elindításához, látogasson el az Első lépések a PowerShell szolgáltatással oldalra. Ha segítségre van szüksége a PowerShell vagy a parancsmagok használatával kapcsolatban, keresse fel a PowerShell súgórendszert.

A PowerShell előfeltételei

A cikkben szereplő PowerShell használatához Windows PowerShell 5.x verzió szükséges . A gépen futó PowerShell-verzió ellenőrzéséhez futtassa a következő parancsot:

$PSVersionTable.PSVersion

Ha elavult verziója van, lépjen a Meglévő Windows PowerShell frissítése című témakörre.

Fontos

A dokumentumban leírt modulok .NET-keretrendszer-t használnak, ami nem kompatibilis a PowerShell 6.0-s és újabb verzióival. Ezek a későbbi verziók a .NET Core-t használják.

Modul telepítése és bejelentkezés

PowerShell-parancsmagok futtatása alkalmazáskészítők számára:

  1. A PowerShell futtatása rendszergazdaként.

    Képernyőkép, amely bemutatja, hogyan futtathatja a PowerShell rendszergazdaként.

  2. Importálja a szükséges modulokat.

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

    Alternatív megoldásként, ha nem rendelkezik rendszergazdai jogosultságokkal a számítógépen, használja a paramétert a -Scope CurrentUser telepítéshez.

    Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -Scope CurrentUser
    Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber -Scope CurrentUser
    
  3. Ha a rendszer arra kéri, hogy fogadja el az adattár InstallationPolicy értékének módosítását , gépeléssel fogadja el [A] Yes az összes modult, majd nyomja meg az Aegyes modulok gombját. Enter

    Képernyőkép arról, hogy hol fogadható el az InstallationPolicy érték a PowerShell.

  4. A parancsok elérése előtt megadhatja hitelesítő adatait. A hitelesítő adatok legfeljebb nyolc órán keresztül frissülnek, mielőtt újra be kell jelentkeznie. Ha a hitelesítő adatok nincsenek megadva a parancs végrehajtása előtt, megjelenik a hitelesítő adatok kérése.

    # 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. Opcionálisan egy adott végpont is megcélozható. Az alapértelmezett végpont prod. Ha egy felhasználó olyan PowerShell-szkriptet szeretne futtatni, amely egy nem gyártási régióban (például GCC) lévő környezetet céloz meg, a -Endpoint paraméter módosítható usgov a GCC Moderate vagy usgovhigh a GCC High dod vagy a GCC DOD esetében. A támogatott végpontok teljes listája: "prod,előzetes verzió,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" 
    

Modul frissítések

Az összes PowerShell modul verzióját a Get-Module használatávalellenőrizheti.

Get-Module

Az Update-Module használatávalpedig frissítheti az összes PowerShell modult a legújabbra.

Update-Module

Másik lehetőségként ellenőrizze a modulok verzióját a Power Platform Get-Module és a paraméter használatával -Name .

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

Frissítse a Power Platform PowerShell modulokat az Update-Module és a paraméter használatával -Name .

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

Power Apps-parancsmagok alkalmazáskészítőknek

A Power Apps-parancsmagok előfeltételei

Az érvényes Power Apps licenccel rendelkező felhasználók végrehajthatják a parancsmagokban található műveleteket. Azonban csak a velük létrehozott vagy megosztott erőforrásokhoz, például alkalmazásokhoz és folyamatokhoz férhetnek hozzá.

Cmdlet lista - Készítő parancsmagok

Feljegyzés

Frissítettünk néhány parancsmagfüggvénynevet a legújabb kiadásban, hogy megfelelő előtagokat adjunk hozzá az ütközések megelőzéséhez. A változások áttekintéséhez tekintse meg az alábbi táblázatot.

Purpose Parancsmag
Adjon hozzá egy vászonalkalmazást egy Microsoft Dataverse megoldáshoz Set-PowerAppAsSolutionAware
Környezetek olvasása és frissítése Get-AdminPowerAppEnvironment(korábban Get-PowerAppsEnvironment)
Get-FlowEnvironment
Restore-PowerAppEnvironment(korábban Restore-AppVersion)
Olvassa el, frissítse és törölje a vászonalkalmazást Get-AdminPowerApp(korábban Get-App)
Remove-AdminPowerApp(korábban Remove-App)
Publish-AdminPowerApp (korábban Publish-App)
Olvassa el, frissítse és törölje a vászonalkalmazások engedélyét Get-AdminPowerAppRoleAssignment(korábban Get-AppRoleAssignment)
Remove-AdminPowerAppRoleAssignment(korábban Remove-AppRoleAssignment)
Olvassa el, frissítse és törölje a folyamatot Get-AdminFlow
Enable-AdminFlow
Disable-AdminFlow
Remove-AdminFlow
Olvassa el, frissítse és törölje az áramlási engedélyeket Get-AdminFlowOwnerRole
Set-AdminFlowOwnerRole
Remove-AdminFlowOwnerRole
Olvassa el és válaszoljon az adatfolyam-jóváhagyásokra Get-AdminFlowApprovalRequest
Remove-AdminFlowApprovals
Olvassa el és törölje a kapcsolatokat Get-AdminPowerAppConnection(korábban Get-Connection)
Remove-AdminPowerAppConnection(korábban Remove-Connection)
Olvassa el, frissítse és törölje a csatlakozási engedélyeket Get-AdminPowerAppConnectionRoleAssignment(korábban Get-ConnectionRoleAssignment)
Set-AdminPowerAppConnectionRoleAssignment(korábban Set-ConnectionRoleAssignment)
Remove-AdminPowerAppConnectionRoleAssignment(korábban Remove-ConnectionRoleAssignment)
Olvassa el és törölje a csatlakozókat Get-AdminPowerAppConnector(korábban Get-Connector)
Remove-AdminPowerAppConnector(korábban Remove-Connector)
Összekötő egyéni engedélyeinek hozzáadása, olvasása, frissítése és törlése Get-AdminPowerAppConnectorRoleAssignment(korábban Get-ConnectorRoleAssignment)
Get-PowerAppConnectorRoleAssignment(korábban Set-ConnectorRoleAssignment)
Remove-PowerAppConnectorRoleAssignment(korábban Remove-ConnectorRoleAssignment)
A házirend URL-mintájának olvasása, hozzáadása és eltávolítása Get-PowerAppPolicyUrlPatterns
New-PowerAppPolicyUrlPatterns
Remove-PowerAppPolicyUrlPatterns
Felügyeleti alkalmazások olvasása, regisztrálása és eltávolítása Get-PowerAppManagementApp
Get-PowerAppManagementApps
Új PowerAppManagementApp
Remove-PowerAppManagementApp
A védelmi kulcsok olvasása, létrehozása, frissítése és importálása Get-PowerAppRetrieveAvailableTenantProtectionKeys
Get-PowerAppGenerateProtectionKey
Get-PowerAppRetrieveTenantProtectionKey
Új PowerAppImportProtectionKey
Set-PowerAppTenantProtectionKey

Power Apps-parancsmagok rendszergazdáknak

A rendszergazdákkal kapcsolatos Power Apps további információkért és Power Automate parancsmagokért lásd: Első lépések a PowerShell rendszergazdáknak Power Platform .

Tippek

  • Használja Get-Help az a után, CmdletName hogy megkapja a példák listáját.

    A Get-Help parancs használatát bemutató képernyő.

  • A kötőjel - beírása után a beviteli címkék közötti váltáshoz nyomja meg Tab a gombot. Helyezze ezt a jelzőt a parancsmag neve után.

Példa parancsokra:

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

Működési példák

Az alábbiakban néhány gyakori forgatókönyvet mutatunk be, amelyek bemutatják, hogyan használhat új és meglévő Power Apps parancsmagokat.

Környezeti parancsok

Ezekkel a parancsokkal részletes információkat szerezhet a bérlő környezetéről és frissítheti azt.

Megjeleníti az összes környezet listáját

Get-AdminPowerAppEnvironment

Visszaadja a bérlő egyes környezeteinek listáját az egyes környezetek részleteivel (például a környezet nevével (guid), megjelenítendő név, helyével, létrehozójával stb.).

Az alapértelmezett környezet részleteinek megjelenítése

Get-AdminPowerAppEnvironment –Default

Csak a bérlő alapértelmezett környezetének adatait adja vissza.

Megjeleníti egy adott környezet részleteit

Get-AdminPowerAppEnvironment –EnvironmentName 'EnvironmentName'

Feljegyzés

A EnvironmentName mező egy egyedi azonosító, amely eltér a DisplayName mezőtől (lásd az alábbi kép kimenetének első és második mezőjét).

Get-AdminEnvironment parancs.

Power Apps parancsok

Ezeket a műveleteket az Power Apps adatok olvasására és módosítására használják a bérlőben.

Megjeleníti a Power Apps teljes listáját

Get-AdminPowerApp

Visszaadja a bérlő összes Power Apps listáját az egyes bérlők adataival (például alkalmazásnév (guid), megjelenítendő név, létrehozó stb.).

Megjeleníti a Power Apps teljes listáját, amely megegyezik a beviteli megjelenítési névvel

Get-AdminPowerApp 'DisplayName'

Ez a parancs felsorolja a bérlő összes Power Apps olyan elemét, amely megfelel a megjelenítendő név.

Feljegyzés

Használjon idézőjeleket a szóközöket tartalmazó bemeneti értékek körül. Használja például a "Saját alkalmazás neve" kifejezést.

Kiemelt alkalmazás

Set-AdminPowerAppAsFeatured –AppName 'AppName'

A kiemelt alkalmazásokat csoportosítják, és a lista elejére helyezik a Power Apps mobillejátszóban.

Feljegyzés

A környezetekhez hasonlóan az AppName mező is egyedi azonosító, amely eltér a DisplayName mezőtől. Ha a megjelenített név alapján szeretne műveleteket végrehajtani, néhány funkció lehetővé teszi a csővezeték használatát (lásd a következő funkciót).

Készítsen egy alkalmazást Hero alkalmazásba a csővezeték segítségével

Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero

Egy fő alkalmazás jelenik meg a lista tetején a Power Apps mobillejátszóban. Csak egy Hero alkalmazás lehet.

A két parancsmag közötti pipe | karakter az első parancsmag kimenetét veszi át, és a második bemeneti értékeként adja át, ha a függvény a cső befogadására van írva.

Feljegyzés

Az alkalmazásoknak már kiemelt alkalmazásnak kell lenniük, mielőtt hőssé változnak.

Mutassa meg az egyes felhasználók tulajdonában lévő alkalmazások számát

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

A natív PowerShell-funkciókat a Power Apps parancsmagokkal kombinálhatja az adatok további manipulálásához. Itt a Kiválasztás funkciót használjuk a Tulajdonos attribútum (objektum) elkülönítéséhez a Get-AdminApp objektumtól. Ezután elkülönítjük a tulajdonos objektum nevét azáltal, hogy ezt a kimenetet egy másik Select függvénybe vonjuk be. Végül, ha a második Select funkció kimenetet átadja a Group funkciónak, egy szép táblázatot kap, amely tartalmazza az egyes tulajdonosok alkalmazásai számát.

Get-AdminPowerApp parancs.

Jelenítse meg az alkalmazások számát az egyes környezetekben

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

Get-AdminPowerApp környezet.

Power Apps felhasználói adatok letöltése

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

Az előző parancs a Megadott szövegfájlban tárolja a Power Apps felhasználói adatait (a bemeneti felhasználó alapszintű használati adatait a felhasználónévn keresztül). Létrehoz egy új fájlt, ha nincs ilyen nevű fájl, és felülírja a szövegfájlt, ha már létezik.

Hozzárendelt felhasználói licencek listájának exportálása

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

Az összes hozzárendelt felhasználói licencet (Power Apps és Power Automate) exportálja a bérlőjébe egy táblázatos nézetű .csv fájlba. Az exportált fájl önkiszolgáló, regisztrációs, belső próbacsomagokat és az azonosítóból Microsoft Entra származó csomagokat is tartalmaz. A belső próbacsomagok a rendszergazdák számára nem láthatók a Microsoft 365 felügyeleti központjában.

Az exportálás eltarthat egy ideig a nagy számú Microsoft Power Platform-felhasználóval rendelkező bérlők számára is.

Feljegyzés

A Get-AdminPowerAppLicenses parancsmag kimenete csak a Power Platform-szolgáltatásokhoz (például Power Apps, Power Automate vagy Power Platform felügyeleti központ) hozzáférő felhasználók licenceit tartalmazza. Azok a felhasználók, akik a Microsoft Entra-azonosítóban (általában a Microsoft 365 felügyeleti központban) hozzárendelt licencekkel rendelkeznek, de soha nem fértek hozzá a Power Platform-szolgáltatásokhoz, nem tartalmazzák a licenceiket a létrehozott .csv kimenetben. Továbbá, mivel a Power Platform licencelési szolgáltatásai gyorsítótárazják a licenceket, a Microsoft Entra ID-ban a licenc-hozzárendelések frissítései akár hét napot is igénybe vehetnek, hogy tükrözzék a szolgáltatáshoz nemrég nem hozzáférő felhasználók kimenetét.

Bejelentkezett felhasználó beállítása a vászonalapú alkalmazás tulajdonosaként

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

A Power App tulajdonosi szerepkörét az aktuális felhasználóra módosítja, és az eredeti tulajdonost "megtekintheti" szerepkörtípusra cseréli.

Feljegyzés

Az AppName és a EnvironmentName mezők az egyedi azonosítók (guid-ok), nem pedig a megjelenítendő nevek.

A törölt vászonalapú alkalmazások listájának megjelenítése a környezetben

Get-AdminDeletedPowerAppsList -EnvironmentName 'EnvironmentName'

Ez a parancs megjeleníti az összes nemrég törölt vászonalapú alkalmazást, mivel előfordulhat, hogy még mindig helyreállnak. A visszaállítható időtartam 28 nap. A 28 nap után törölt alkalmazások nem jelennek meg ebben a listában, és nem állíthatók helyre.

Törölt vászonalapú alkalmazás helyreállítása

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

Ez a parancs helyreállítja a Get-AdminDeletedPowerAppsList parancsmagon keresztül felderíthető vászonalapú alkalmazást. Azok a vászonalapú alkalmazások, amelyek nem jelennek meg a Get-AdminDeletedPowerAppsList listában, nem állíthatók helyre.

Egyéni SharePoint-űrlapkörnyezet kijelölése

Az alábbi parancsmagok használhatók annak megadására és ellenőrzésére, hogy az alapértelmezett környezet helyett mely környezetben vannak mentve az egyéni SharePoint-űrlapok. Amikor az egyéni űrlapokhoz SharePoint kijelölt környezet megváltozik, az újonnan létrehozott egyéni űrlapok mentésére ebben a környezetben történik a rendszer. A meglévő egyéni űrlapok nem kerülnek át automatikusan más környezetbe, mivel ezek a parancsmagok használatban vannak. Ahhoz, hogy egy felhasználó egyéni űrlapot hozzon létre egy kijelölt környezetben,szükséges, hogy a felhasználó Környezetkészítő szerepkörrel rendelkezzen. A felhasználók a Power Platform felügyeleti központban kaphatják a Környezetkészítő szerepkört.

Minden olyan környezet törölhető, amely nem az alapértelmezett környezet. Ha a kijelölt SharePoint egyéni űrlapkörnyezetet törlik, az egyéni űrlapok is törlődnek vele.

Get-AdminPowerAppSharepointFormEnvironment  

Ez a parancs visszaadja az EnvironmentName újonnan létrehozott SharePoint egyéni űrlapokhoz jelenleg kijelölt környezethez tartozó értéket. Ha még nincs kijelölve környezet, a rendszer az alapértelmezett környezetet adja vissza.

Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName' 

Ez a parancs az újonnan létrehozott SharePoint egyéni űrlapok mentési helyét jelöli ki az alapértelmezett környezet helyett. A meglévő egyéni űrlapok nem kerülnek át automatikusan az újonnan kijelölt környezetbe. Egyéni űrlapokhoz SharePoint csak éles környezet jelölhető ki.

Reset-AdminPowerAppSharepointFormEnvironment  

Ez az alapértelmezett környezetet visszaállítja kijelölt környezetként az egyéni SharePoint-űrlapok mentéséhez.

Bérlői beállítások megjelenítése az alkalmazások mindenkivel való megosztásához

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

Ez a beállítás vezérli, hogy a környezetfejlesztő biztonsági szerepkör felhasználói megoszthatnak-e vászonalapú alkalmazásokat a szervezet Mindenki csoportjával. Ha a beállítás true (igaz ) értékre van állítva, csak a rendszergazdai szerepkörrel (Dynamics 365 rendszergazda, Power Platform szolgáltatás-rendszergazda, Microsoft Entra bérlői rendszergazda) rendelkező felhasználók oszthatnak meg alkalmazásokat a szervezet minden tagjával.

A bérlői beállítások értékétől függetlenül a megosztási jogosultsággal rendelkező készítők bármilyen méretű biztonsági csoportokkal megoszthatnak alkalmazásokat. Ez a vezérlő csak azt határozza meg, hogy a Mindenki rövidítés használható-e megosztáskor.

Bérlői beállítások módosítása az alkalmazások mindenkivel való megosztásához

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

A szervezet irányítási hibaüzenet-tartalmának megjelenítése

Ha azt adja meg, hogy a cégirányítási hibaüzenet tartalma megjelenjen a hibaüzenetekben, a hibaüzenet tartalma akkor jelenik meg, ha a készítők azt észlelik, hogy nincs engedélyük az alkalmazások mindenkivel való megosztására. Lásd: A PowerShell cégirányítási hibaüzenet-tartalomra vonatkozó parancsai.

Társítás környezetfüggő folyamatokban egy alkalmazáshoz

Az alkalmazások környezetében a folyamatokat az alkalmazáshoz társítva függőséget hozhat létre az alkalmazás és a folyamatok között. Ha szeretne többet megtudni a környezetfolyamatokról, olvassa el , hogy milyen Power Automate lehetőségeket tartalmaznak a Power Apps licencek.

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

A EnvironmentName és a FlowName fájl a folyamat url-címében található:

  • Nem megoldási folyamat esetén az URL-cím így néz ki:

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

    A GUID után environments/ a EnvironmentName, az utána flows/ következő GUID pedig a FlowName

  • A megoldási folyamat URL-címe így néz ki:

    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
    

    A GUID után environments/ a EnvironmentName, az utána flows/ következő GUID pedig a FlowName

  • A vászonalapú alkalmazás AppName neve a vászonalapú alkalmazás részleteit tartalmazó oldalon található.

    Képernyőkép, amely azt mutatja, hogy a vászonalapú alkalmazás AppName neve megtalálható a vászonalapú alkalmazás részleteit tartalmazó oldalon.

  • A modellvezérelt alkalmazások AppName neve a megoldáskezelőben található.

    Képernyőkép, amely azt mutatja, hogy egy modellvezérelt alkalmazás AppName neve megtalálható a megoldáskezelőben.

  • A példák megtekintéséhez írja be a következőt: get-help Add-AdminFlowPowerAppContext -examples

  • További információért írja be a következőt: get-help Add-AdminFlowPowerAppContext -detailed

  • Műszaki információk beszerzéséhez írja be a következőt: get-help Add-AdminFlowPowerAppContext -full

Az alkalmazás kontextusfolyamataiból való eltávolítás

Ezzel a PowerShell-paranccsal eltávolíthatja a folyamatok és egy alkalmazás közötti függőséget. Az Remove-AdminFlowPowerAppContext eltávolítja az alkalmazáskörnyezetet az adott folyamatból.

    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 parancsok

Ezekkel a fontos parancsokkal a következőkkel kapcsolatos felügyeletet végezheti Power Automate el.

A rendszergazdák teljes listáját Power Automate és Power Apps parancsmagjait lásd: Első lépések a PowerShell rendszergazdáknak Power Platform .

Az összes áramlás megjelenítése

Get-AdminFlow

Visszaadja a bérlő összes áramlásának listáját.

A folyamatáram-tulajdonos szerepének részleteinek megjelenítése

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

Visszaadja a megadott folyamat tulajdonosának adatait.

Feljegyzés

A környezetekhez hasonlóan és,FlowNamePowerApps az egyedi azonosító (guid), amely eltér a folyamat megjelenítendő név.

Megjeleníti a folyamatos felhasználói adatokat

Get-AdminFlowUserDetails –UserId $Global:currentSession.userId

Visszaadja a felhasználó adatait az áramlás használatával kapcsolatban. Ebben a példában a PowerShell munkamenet aktuálisan bejelentkezett felhasználójának felhasználói azonosítóját használjuk bemenetként.

Távolítsa el az adatfolyam felhasználói adatait

Remove-AdminFlowUserDetails –UserId 'UserId'

Teljes mértékben törli a folyamatos felhasználó adatait a Microsoft adatbázisából. Az összes adatfolyamot, amely a felhasználó birtokában van, törölni kell, mielőtt az adatfolyam felhasználói adatait meg lehet tisztítani.

Feljegyzés

A UserId mező a felhasználó rekordjának Microsoft Entra objektumazonosítója, amely a Azure portálon található a Felhasználói Microsoft Entra profil>azonosítója>objektumazonosító> alatt. Adminisztrátornak kell lennie, hogy innen hozzáférhessen ezekhez az adatokhoz.

Az összes folyamat exportálása CSV-fájlba

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

Exportálja a bérlő összes folyamatát táblázatos nézetű .csv fájlba.

Folyamatok hozzáadása megoldásokhoz Dataverse

Add-AdminFlowsToSolution -EnvironmentName <String>

Migrálja a környezetben lévő összes nem oldódó folyamatot.

A paraméterváltozatok csak bizonyos folyamatok áttelepítésére, egy adott megoldáshoz való hozzáadásra, vagy egyszerre csak meghatározott számú folyamat áttelepítésére használhatók.

Technikai részletekért lásd: Add-AdminFlowsToSolution.

HTTP-műveletfolyamatok listázása

Get-AdminFlowWithHttpAction -EnvironmentName <String>

HTTP-műveletekkel rendelkező folyamatok listázása.

Megjelenítendő név Folyamatnév KörnyezetNév
Számla HTTP-ének lekérése flow-1 1. környezet
Számla fizetése alkalmazásból flow-2 environment-2
Fiók egyeztetése flow-3 környezet-3

API kapcsolati parancsok

Tekintse meg és kezelje az API-kapcsolatokat a bérlőben.

Az összes natív kapcsolat megjelenítése az alapértelmezett környezetben

Get-AdminPowerAppEnvironment -Default | Get-AdminPowerAppConnection

Megjeleníti az összes alapértelmezett környezetben lévő API-kapcsolat listáját. A natív kapcsolatok a készítő portál Dataverse>Kapcsolatok fülön találhatók a Power Apps-ban.

Jelenítse meg az összes egyedi csatlakozót a bérlőben

Get-AdminPowerAppConnector

Visszaadja a bérlő összes egyedi csatlakozójának listáját.

Feljegyzés

Get-AdminPowerAppConnector Nem sorolja fel a megoldásban található egyéni összekötőket. Ez egy ismert korlátozás.

Adatházirend-parancsok

Ezek a parancsmagok szabályozzák a bérlő adatszabályzatait.

Adatházirend létrehozása

New-DlpPolicy

Új adatházirendet hoz létre a bejelentkezett rendszergazda bérlőjéhez.

Adatszabályzat-objektumok listájának lekérése

Get-DlpPolicy

Lekérdezi a házirendobjektumokat a bejelentkezett rendszergazda bérlője számára.

Feljegyzés

  • Amikor a PowerShell használatával tekint meg egy adatházirendet, az összekötők megjelenítendő neve az adatházirend létrehozásakor vagy az összekötők legutóbbi áthelyezésének időpontjából származik. Az összekötők megjelenítendő nevének új módosításai nem jelennek meg.
  • Amikor a PowerShell használatával tekint meg egy adatházirendet, a rendszer nem ad vissza új összekötőket az alapértelmezett csoportban, amelyeket nem helyeztek át.

Mindkét ismert probléma esetében áthidaló megoldásként helyezze át az érintett összekötőt egy másik csoportba a szabályzaton belül, majd helyezze vissza a megfelelő csoportba. Ezt követően minden összekötő látható a megfelelő névvel.

Adatházirend frissítése

Set-DlpPolicy

Frissíti a házirend részleteit, például a házirend megjelenítendő nevét.

Házirend eltávolítása

Remove-DlpPolicy

Adatházirend törlése.

Adaterőforrás-kivételi parancsmagok

Ezek a parancsmagok lehetővé teszik egy adott erőforrás kivételét vagy feloldását egy szabályzatból.

Adatszabályzat meglévő kivételt képező erőforráslistájának lekérése

Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Új kivételt képező erőforráslista létrehozása adatszabályzathoz

New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources 

Adatszabályzat kivételt képező erőforráslistájának frissítése

Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources 

Adatszabályzat kivételt képező erőforráslistájának eltávolítása

Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Egy erőforrás adatszabályzat alóli kivételéhez a következő információkra van szüksége:

  • Bérlő azonosítója (GUID)
  • Adatházirend-azonosító (GUID)
  • Erőforrás-azonosító (GUID-vel végződik)
  • Erőforrás típusa

Az erőforrás azonosítóját és típusát az alkalmazások esetében a Get-PowerApp, az áramlások esetében pedig a Get-Flow parancssorok segítségével kérheti le.

Példa eltávolító szkriptre

Az azonosítóval f239652e-dd38-4826-a1de-90a2aea584d9 rendelkező folyamat és az azonosítóval 06002625-7154-4417-996e-21d7a60ad624 rendelkező alkalmazás kivételéhez a következő parancsmagokat futtathatjuk:

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

Adatházirend-kivételi élmény az alábbi forgatókönyvekben

# Forgatókönyv Felület
0 A felhasználó olyan alkalmazást indít el, amely nem felel meg az adatszabályzatnak, de kivételt képez az adatszabályzat alól. Az alkalmazás indítása adatszabályzat-kényszerítéssel vagy anélkül folytatódik.
2 A Maker olyan alkalmazást ment, amely nem felel meg az adatszabályzatnak, de kivételt képez az adatszabályzat alól Adatházirend-kivétellel vagy anélkül az adatházirend-megfelelőség nem blokkolja az alkalmazásmentési műveletet. Az adatházirend meg nem felelési figyelmeztetése az adatszabályzat kivételétől függetlenül jelenik meg.
3 A Maker olyan folyamatot ment, amely nem felel meg az adatszabályzatnak, de kivételt képez az adatszabályzat alól Az adatházirend-kivétellel vagy anélkül az adatházirend-megfelelőség nem blokkolja a folyamatmentési műveletet. Az adatházirend meg nem felelési figyelmeztetése nem jelenik meg.

Irányítási hibaüzenet tartalomparancsai

Az alábbi parancsmagok a végfelhasználókat a szervezet cégirányítási referenciaanyagához vezethetik. A parancs tartalmaz egy cégirányítási dokumentációra mutató hivatkozást és egy cégirányítási kapcsolattartót, amikor a cégirányítási vezérlők kérik őket. Ha például a szabályozási hibaüzenet tartalma be van állítva, az megjelenik a Power Apps adatszabályzat-futtatókörnyezeti kényszerítési üzeneteiben.

Irányítási hibaüzenet tartalmának beállítása

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

Az irányítási hibaüzenet URL-címe és az e-mail üzenet külön vagy együtt jelenhet meg. A mezővel engedélyezheti vagy letilthatja a enabled cégirányítási hibaüzenetet.

Cégirányítási hibaüzenetek tartalmi forgatókönyvei

# Forgatókönyv Elérhetőség
0 A felhasználó olyan alkalmazást indít el, amely nem adatházirend-kompatibilis Power Apps használatával jön létre Általánosan elérhető
2 A készítő megoszt egy Power Apps vászonalapú alkalmazást, de nem rendelkezik megosztási jogosultsággal Általánosan elérhető
3 A készítő megoszt egy Power Apps vászonalapú alkalmazást mindenkivel , de nincs jogosultsága megosztani mindenkivel Általánosan elérhető
4 A Maker olyan Power Apps használatával létrehozott alkalmazást ment, amely nem felel meg az adatszabályzatnak Általánosan elérhető
5 A Maker olyan Power Automate-folyamatot ment, amely nem felel meg az adatházirendnek Általánosan elérhető
6 A felhasználó biztonsági csoport tagság nélkül indít el egy alkalmazást a környezethez Dataverse társított biztonsági csoporthoz Általánosan elérhető

Irányítási hibaüzenet tartalmának megjelenítése

Get-PowerAppDlpErrorSettings -TenantId 'TenantId' 

Irányítási hibaüzenet tartalmának frissítése

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

Adatházirend kényszerítése a kapcsolatok megsértésére – környezet

Ezek a parancsmagok lehetővé teszik az adatházirend kikényszerítését a környezeti vagy bérlői kapcsolatok megsértése esetén.

Adatszabályzatok kényszerítése a kapcsolatok megsértésére

Adatszabályzatokat kényszeríthet egy környezetben lévő kapcsolatokra. A kényszerítés letiltja az adatszabályzatokat sértő meglévő kapcsolatokat, és engedélyezi az adatszabályzatokat már nem sértő, korábban letiltott kapcsolatokat.

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName [Environment ID]
Példa környezetkényszerítési parancsfájlra
Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName c4a07cd6-cb14-e987-b5a2-a1dd61346963 

Adatszabályzatok kényszerítése a kapcsolatok megsértése esetén – bérlő

A bérlői kapcsolatokra vonatkozó adatszabályzatok kényszeríthetők. A kényszerítés letiltja az adatszabályzatokat sértő meglévő kapcsolatokat, és engedélyezi az adatszabályzatokat már nem sértő, korábban letiltott kapcsolatokat.

Start-DLPEnforcementOnConnectionsInTenant

A próbalicencek parancsának zárolása

Parancsok:

Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans

Az engedélyezett hozzájárulási tervek parancsmagok segítségével hozzáadható vagy távolítható el egy adott típusú hozzájárulási terv a bérlőtől. A „belső” hozzájárulási csomagok vagy próbalicencek vagy olyan fejlesztői csomagok, amelyekre a felhasználók feliratkozhatnak a Power Apps/Power Automate-portálokon/Power Automate asztali alkalmazáson keresztül. Az "alkalmi előfizetési" vagy "vírusos" hozzájárulási csomagok próbalicencek, amelyekre a https://signup.microsoft.com felhasználók regisztrálhatnak. A rendszergazdák azonosítóval vagy a Microsoft Entra felügyeleti portálon keresztül Microsoft 365 rendelhetnek hozzá felhasználókat.

Alapértelmezés szerint minden típusú hozzájárulási csomag engedélyezve van egy bérlőben. Előfordulhat azonban, hogy a Power Platform rendszergazdája meg szeretné akadályozni, hogy a felhasználók próbalicenceket rendeljenek magukhoz, de a felhasználók nevében továbbra is kioszthatják a próbaverziós licenceket. Ez a szabály a Remove-AllowedConsentPlans -Types "Internal" parancs használatával és a - AllowedToSignUpEmailBasedSubscriptionsUpdate-MgPolicyAuthorizationPolicy beállítás engedélyezésével hajtható végre a Microsoft Entra ID-ban.

Fontos

Ha használja Remove-AllowedConsentPlans, a megadott típusú összes meglévő csomag el lesz távolítva a bérlő összes felhasználójától, és nem állítható helyre. Ez a parancs blokkolja az összes ilyen típusú jövőbeli hozzárendelést. Ha a rendszergazda újra engedélyezni szeretné az Power Platform ilyen típusú csomagokat, használhatja Add-AllowedConsentPlans. Ha meg szeretnék tekinteni az engedélyezett hozzájárulási tervek aktuális állapotát, használhatják Get-AllowedConsentPlans.

Ha kérdése van

Ha megjegyzései, javaslatai vagy kérdései vannak, tegye fel őket a Power Apps felügyeleti közösségi táblájára.