Obsługa PowerShell dla Power Apps i Power Automate

Artykuł
03/05/2024

Dzięki poleceniom cmdlets programu PowerShell dla twórców i administratorów Power Platform wiele zadań związanych z monitorowaniem i zarządzaniem można zautomatyzować. Zadania, które są możliwe tylko ręcznie w dniu dzisiejszym w Power Apps, Power Automate lub centrum działań Power Platform.

Polecenia cmdlet

Polecenia cmdlet to funkcje napisane w języku skryptów programu PowerShell, które umożliwiają wykonywanie poleceń w programie PowerShell. Uruchamianie tych poleceń cmdlet usługi Power Apps pozwala na interakcję z platformą aplikacji biznesowych bez konieczności używania portalu administracyjnego w przeglądarce internetowej.

Polecenia cmdlet można połączyć z innymi funkcjami programu PowerShell w celu pisania złożonych skryptów, które mogą zoptymalizować przepływ pracy. Możesz nadal używać poleceń cmdlet, jeśli nie jesteś administratorem dzierżawy, ale ograniczeniem są zasoby, których jesteś właścicielem. Konto użytkownika administracyjnego używa poleceń cmdlets, które zaczyna się od Admin.

Polecenia cmdlet są dostępne w galerii programu PowerShell jako dwa oddzielne moduły:

Aby uzyskać więcej informacji na temat modułu administratora Power Apps, zobacz tematy Wprowadzenie do korzystania z modułu administratora usługi Power Apps and Microsoft.PowerApps.Administration.PowerShell.

Uwaga

Pomoc techniczna dotycząca Dynamics 365 Government Community Cloud (GCC) poziom 2:

Domyślny punkt końcowy to „prod”. Jeśli użytkownik chce uruchomić skrypt PowerShell przeznaczony dla środowiska GCC, parametr -Endpoint należy zmienić na „usgov” dla GCC Moderate lub „usgovhigh” dla GCC High lub „dod” dla GCC DOD.

Add-PowerAppsAccount -Endpoint "usgov"

Wprowadzenie do programu PowerShell

Jeśli jesteś nowym użytkownikiem programu PowerShell i potrzebujesz pomocy dotyczącej znajdowania i uruchamiania go, przejdź do tematu Wprowadzenie do programu PowerShell. Aby uzyskać pomoc na temat używania programu PowerShell lub poleceń cmdlet, przejdź do systemu pomocy programu PowerShell.

Wymagania wstępne

Program PowerShell w tym artykule wymaga programu Windows PowerShell w wersji 5.x. Aby sprawdzić, która wersja programu PowerShell działa na komputerze, uruchom następujące polecenie:

$PSVersionTable.PSVersion

Jeśli masz nieaktualną wersję, przejdź do uaktualnienia istniejącego programu Windows PowerShell.

Ważne

Moduły opisane w tym dokumencie używają programu .NET Framework, który jest niezgodny z programem PowerShell 6.0 lub nowszym. Te późniejsze wersje korzystają z programu .NET Core.

Instalacja modułu

Aby uruchomić polecenia cmdlet dla twórców aplikacji w PowerShell:

Uruchom program Powershell jako Administrator.

Zaimportuj niezbędne moduły.

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

Jeśli użytkownik nie ma uprawnień administratora na komputerze, może skorzystać z parametru -Scope CurrentUser w celu instalacji.

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

Jeśli zostanie wyświetlony monit o zaakceptowanie zmiany wartości repozytorium InstallationPolicy, zaakceptuj opcję [A] Yes dla wszystkich modułów, wpisując A i naciskając klawisz Enter dla każdego modułu.

Przed uzyskaniem dostępu do dowolnego polecenia podaj swoje poświadczenia za pomocą poniższego polecenia. Poświadczenia są odświeżane przez około osiem godzin, zanim zaistnieje konieczność ponownego zalogowania się.

# 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

Aktualizacje modułu

Aby sprawdzić wersję wszystkich modułów programu PowerShell, możesz użyć polecenia Get-Module.

Get-Module

Można także aktualizować wszystkie moduły programu PowerShell do najnowszego przy użyciu polecenia Update-Module.

Update-Module

Można też sprawdzić wersję modułów Power Platform przy użyciu modułu Pobierz moduł i parametru -Name.

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

Zaktualizuj moduły Power Platform PowerShell, używając Update-Module i parametru -Name.

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

Polecenia cmdlet Power Apps dla twórców aplikacji

Wymagania wstępne

Użytkownicy z prawidłową licencją Power Apps mogą wykonywać operacje w tych poleceniach cmdlets. Mają jednak dostęp tylko do zasobów, takich jak aplikacje i przepływy, które są im tworzone lub udostępniane.

Lista poleceń cmdlet — polecenia cmdlet Kreatora

Uwaga

W najnowszej wersji zaktualizowaliśmy niektóre nazwy funkcji poleceń cmdlet w celu dodania odpowiednich prefiksów, aby zapobiec kolizjom. Zapoznaj się z poniższą tabelą zawierającą omówienie zmian.

Purpose	Polecenia cmdlet
Dodaj aplikację kanwy do rozwiązania Microsoft Dataverse	Set-PowerAppAsSolutionAware
Odczytuj i aktualizuj środowiska	Get-AdminPowerAppEnvironment(poprzednio Get-PowerAppsEnvironment) Get-FlowEnvironment Restore-PowerAppEnvironment(wcześniej Restore-AppVersion)
Odczytuj, aktualizuj i usuwaj aplikację kanwy	Get-AdminPowerApp(poprzednio Get-App) Remove-AdminPowerApp(poprzednio Remove-App) Publish-AdminPowerApp (poprzednio Publish-App)
Odczytuj, aktualizuj i usuwaj uprawnienia aplikacji kanwy	Get-AdminPowerAppRoleAssignment(wcześniej Get-AppRoleAssignment) Remove-AdminPowerAppRoleAssignment(wcześniej Remove-AppRoleAssignment)
Odczytuj, aktualizuj i usuwaj przepływ	Get-AdminFlow Enable-AdminFlow Disable-AdminFlow Remove-AdminFlow
Odczytuj, aktualizuj i usuwaj uprawnienia przepływu	Get-AdminFlowOwnerRole Set-AdminFlowOwnerRole Remove-AdminFlowOwnerRole
Odczyt i odpowiadanie na zatwierdzania przepływu	Get-AdminFlowApprovalRequest Remove-AdminFlowApprovals
Odczyt i usuwanie połączeń	Get-AdminPowerAppConnection(wcześniej Get-Connection) Remove-AdminPowerAppConnection(wcześniej Remove-Connection)
Odczytuj, aktualizuj i usuwaj uprawnienia połączenia	Get-AdminPowerAppConnectionRoleAssignment(wcześniej Get-ConnectionRoleAssignment) Set-AdminPowerAppConnectionRoleAssignment(wcześniej Get-ConnectionRoleAssignment) Remove-AdminPowerAppConnectionRoleAssignment(wcześniej Remove-ConnectionRoleAssignment)
Odczyt i usuwanie łączników	Get-AdminPowerAppConnector(poprzednio Get-Connector) Remove-AdminPowerAppConnector(poprzednio Remove-Connector)
Uprawnienia do dodawania, odczytu, aktualizacji i usuwania łączników niestandardowych	Get-AdminPowerAppConnectorRoleAssignment(poprzednio Get-ConnectorRoleAssignment) Get-PowerAppConnectorRoleAssignment(poprzednio Set-ConnectorRoleAssignment) Remove-PowerAppConnectorRoleAssignment(poprzednio Remove-ConnectorRoleAssignment)
Wzorce adresów URL dotyczące odczytywania, dodawania i usuwania zasad	Get-PowerAppPolicyUrlPatterns New-PowerAppPolicyUrlPatterns Remove-PowerAppPolicyUrlPatterns
Odczytuj, rejestruj i usuwaj aplikacje do zarządzania	Get-PowerAppManagementApp Get-PowerAppManagementApps New-PowerAppManagementApp Remove-PowerAppManagementApp
Odczyt, tworzenie, aktualizowanie i importowanie kluczy ochrony	Get-PowerAppRetrieveAvailableTenantProtectionKeys Get-PowerAppGenerateProtectionKey Get-PowerAppRetrieveTenantProtectionKey New-PowerAppImportProtectionKey Set-PowerAppTenantProtectionKey

Polecenia cmdlet Power Apps dla administratorów

Aby uzyskać więcej informacji na temat poleceń cmdlets programu Power Apps i Power Automate dla administratorów, zobacz Wprowadzenie do programu PowerShell dla administratorów Power Platform.

Wskazówki

Aby wyświetlić listę przykładów, użyj Get-Help, a następnie CmdletName.
Po wpisaniu myślnika - można nacisnąć Tab, aby cyklicznie przełączać się po tagach wejściowych. Umieść ten adres za nazwą polecenia cmdlet.

Przykładowe polecenia:

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

Przykłady operacji

Poniżej przedstawiono kilka typowych scenariuszy używania nowych i istniejących poleceń cmdlet usługi Power Apps.

Polecenia dotyczące środowisk
Polecenia Power Apps
Polecenia Power Automate
Polecenia połączenia interfejsu API
Polecenia zasad ochrony przed utratą danych (DLP)
Polecenia cmdlet wyjątku zasobu DLP
Polecenia Blokuj licencje wersji próbnej

Polecenia dotyczące środowisk

Użyj tych poleceń, aby uzyskać szczegółowe informacje o środowiskach i aktualizacjach środowisk w dzierżawie.

Zostanie wyświetlona lista wszystkich środowisk.

Get-AdminPowerAppEnvironment

Zwraca listę wszystkich środowisk w dzierżawie, szczegóły każdego z nich, (na przykład nazwę środowiska (identyfikator GUID), nazwę wyświetlaną, lokalizację, autora i inne).

Wyświetlanie szczegółowych informacji o domyślnym środowisku użytkownika

Get-AdminPowerAppEnvironment –Default

Zwraca informacje dotyczące tylko domyślnego środowiska dzierżawcy.

Wyświetl szczegóły określonego środowiska

Get-AdminPowerAppEnvironment –EnvironmentName 'EnvironmentName'

Uwaga

Pole EnvironmentName zawiera unikatowy identyfikator, który różni się od wartości pola DisplayName (zobacz pierwsze i drugie pole w danych wyjściowych na poniższej ilustracji).

Polecenie Get-AdminEnvironment.

Polecenia Power Apps

Te operacje służą do odczytu i modyfikowania danych Power Apps w dzierżawie.

Wyświetl listę wszystkich Power Apps

Get-AdminPowerApp

Zwraca listę wszystkich środowisk w dzierżawcy usługi Power Apps, szczegóły każdego z nich, (na przykład nazwę aplikacji (identyfikator GUID), nazwę wyświetlaną, lokalizację, autora i inne).

Wyświetlanie listy wszystkich Power Apps odpowiadających danym nazwom wejściowym

Get-AdminPowerApp 'DisplayName'

To polecenie zawiera listę wszystkich pozycji Power Apps znajdujących się w dzierżawie, które odpowiadają wyświetlanej nazwie.

Uwaga

Użyj cytatów wokół danych wejściowych zawierających spacje. Na przykład użyj „Nazwa mojej aplikacji”.

Poleć aplikację

Set-AdminPowerAppAsFeatured –AppName 'AppName'

Polecane aplikacje są zgrupowane i umieszczane w górnej części listy w odtwarzaczu mobilnym Power Apps.

Uwaga

tak jak w przypadku środowisk, pole AppName zawiera unikatowy identyfikator, który różni się od wartości pola DisplayName. Aby wykonywać operacje oparte na wyświetlanej nazwie, niektóre funkcje umożliwiają korzystanie z potoku (zobacz następną funkcję).

Tworzenie aplikacji jako aplikacji głównej przy użyciu potoku

Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero

Aplikacja główna jest wyświetlana na początku listy w odtwarzaczu mobilnym usługi Power Apps. Może istnieć tylko jedna aplikacja główna.

Znak potoku | między dwoma cmdlets pobiera wartość wyjściową pierwszego polecenia cmdlet i przekazuje ją jako wartość wejściową drugiego, o ile funkcja zostanie wpisana w celu dostosowania potoku.

Uwaga

Przed zmianą na Hero aplikacja musi już być polecana.

Wyświetlanie liczby aplikacji, których właścicielem jest każdy użytkownik

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

Macierzyste funkcje programu PowerShell można połączyć z poleceniami cmdlet Power Apps, aby dalej manipulować danymi. W tym celu należy użyć funkcji Wyboru w celu wyizolowania atrybutu Właściciel (objektu) z obiektu Get-AdminApp. Następnie należy wyizolować nazwę obiektu będącego właścicielem, przeprowadzając dane wyjściowe do innej funkcji wyboru. Na koniec przekazanie drugiej funkcji wyboru do funkcji grupowej powoduje pokazuje przejrzystą tabelę danych, która zawiera liczbę wszystkich aplikacji poszczególnych właścicieli.

Polecenie Get-AdminPowerApp.

Wyświetlanie liczby aplikacji w każdym środowisku

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

Środowisko Get-AdminPowerApp.

Pobierz szczegóły użytkownika Power Apps

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

Powyższe polecenie przechowuje szczegóły użytkownika usługi Power Apps (podstawowe informacje dotyczące użycia przez użytkownika wejściowego za pomocą nazwy głównej użytkownika) w określonym pliku tekstowym. Spowoduje to utworzenie nowego pliku, jeśli plik o takiej nazwie nie istnieje, i zastąpienie pliku tekstowego, jeśli istnieje.

Eksportowanie listy przydzielonych licencji użytkownika

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

Eksportuje wszystkie przypisane licencje użytkownika (Power Apps i Power Automate) z Twojej dzierżawy w postaci pliku CSV widoku tabelarycznego. Wyeksportowany plik zawiera wewnętrzne plany na wersje próbne z samodzielną rejestracją oraz plany pobrane z usługi Tożsamość Microsoft Entra. Wewnętrzne plany wersji próbnej nie są widoczne dla administratorów w centrum administracyjnym Microsoft 365.

Eksportowanie może zająć dużo czasu, jeśli dzierżawy zajmują dużą liczbę użytkowników Microsoft Power Platform.

Uwaga

Wyniki polecenia cmdlet Get-AdminPowerAppLicenses obejmują jedynie licencje dla użytkowników, którzy uzyskali dostęp do usług Power Platform (na przykład Power Apps, Power Automate lub centrum administracyjnego Power Platform). Użytkownicy, do których przypisano licencje w usłudze Microsoft Entra ID (zazwyczaj za pośrednictwem centrum administracyjnego Microsoft 365), ale którzy nigdy nie uzyskiwali dostępu do usług Power Platform, nie będą mieli licencji zawartych w wygenerowanym pliku wyjściowym CSV. Ponadto, ponieważ usługi licencjonowania Power Platform buforują licencje, aktualizacje dokonane w przypisaniach licencji w Microsoft Entra ID mogą potrwać do siedmiu dni, aby odzwierciedlić je w danych wyjściowych dla użytkowników, którzy ostatnio nie uzyskali dostępu do usługi.

Ustawianie zalogowanego użytkownika jako właściciela aplikacji kanwy

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

Zmienia rolę właściciela PowerApp na bieżącego użytkownika i zastępuje pierwotnego właściciela jako typ roli „może wyświetlić”.

Uwaga

Pola AppName i EnvironmentName zawierają unikatowe identyfikatory (identyfikatory GUID), a nie nazwy wyświetlane.

Wyświetlanie listy usuniętych aplikacji kanwy w środowisku

Get-AdminDeletedPowerAppsList -EnvironmentName 'EnvironmentName'

To polecenie powoduje wyświetlenie wszystkich aplikacji kanw, które zostały ostatnio usunięte, ponieważ mogą zostać odzyskać.

Odzyskiwanie usuniętej aplikacji kanwy

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

To polecenie umożliwia odzyskać aplikację z kanwą, która można wykrywać za pomocą polecenia cmdlet Get-AdminDeletedPowerAppsList. Nie można odzyskać żadnej aplikacji z kanwą, która nie jest wyświetlana w obszarze Get-AdminDeletedPowerAppsList.

Wyznaczanie środowiska niestandardowych formularzy programu SharePoint

W celu określenia i sprawdzenia, w którym środowisku — zamiast domyślnego — są zapisywane niestandardowe formularze programu SharePoint, można użyć poleceń cmdlet wymienionych poniżej. W przypadku zmiany środowiska przeznaczonego dla formularzy niestandardowych SharePoint w tym środowisku są zapisywane nowo utworzone formularze niestandardowe. Istniejące niestandardowe formularze nie są automatycznie migrowane do różnych środowisk w reakcji na użycie tych poleceń cmdlet. Aby użytkownik mógł utworzyć niestandardowy formularz w wyznaczonym środowisku, musi posiadać rolę Twórca środowiska. Użytkownikom można przyznać rolę Twórca środowiska w centrum administracyjnym platformy Power Platform.

Każde środowisko inne niż domyślne można usunąć. Po usunięciu wyznaczonego środowiska niestandardowych formularzy programu SharePoint niestandardowe formularze są usuwane razem z nim.

Get-AdminPowerAppSharepointFormEnvironment

To polecenie zwraca wartość EnvironmentName środowiska aktualnie wyznaczonego dla nowo tworzonych niestandardowych formularzy programu SharePoint. Jeśli środowisko nigdy nie było wyznaczone, jest zwracane domyślne środowisko.

Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName'

To polecenie oznacza środowisko, w którym są zapisywane nowo utworzone formularze niestandardowe SharePoint zamiast środowiska domyślnego. Istniejące niestandardowe formularze nie są automatycznie migrowane do nowego środowiska. Dla niestandardowych formularzy programu SharePoint można wyznaczać tylko środowisko produkcyjne.

Reset-AdminPowerAppSharepointFormEnvironment

Przywraca środowisko domyślne jako wyznaczone do zapisywania niestandardowych formularzy programu SharePoint.

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

To ustawienie umożliwia określenie, czy użytkownicy z rolą twórca środowiska mogą udostępniać aplikacje kanw dla Wszystkich w organizacji. Gdy ustawienie jest ustawione na true, tylko użytkownicy z rolą administratora (admin Dynamics 365, administratorem usługi Power Platform, administratorem dzierżawy Microsoft Entra) mogą udostępniać aplikacje dla wszystkich w organizacji.

Niezależnie od wartości ustawień dzierżawcy twórcy z uprawnieniem do udostępniania mogą udostępniać aplikacje grupom zabezpieczeń dowolnej wielkości. Ten formant określa jedynie, czy podczas udostępniania może być używana skrótowa kontrolka Wszyscy.

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

Powierzchnia zawartości komunikatu o błędzie w błąd w organizacji

Jeśli określisz zawartość komunikatu o błędzie ładu, która ma być wyświetlana w komunikatach o błędach, będzie ona widoczna w komunikacie o błędzie, gdy twórcy zauważą, że nie mają uprawnień do udostępniania aplikacji wszystkim użytkownikom. Zobacz polecenia komunikatów o błędach programu PowerShell.

Dołączanie przepływów kontekstowych do aplikacji

Przyporządkuj przepływy w kontekście aplikacji do aplikacji, aby stworzyć zależność między aplikacją a przepływami. Aby dowiedzieć się więcej o przepływach kontekstu, zobacz Jakie możliwości usługi Power Automate są zawarte w licencjach usługi Power Apps?

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

W adresie URL przepływu znajdują się EnvironmentName i FlowName:

W przypadku przepływu bez rozwiązania adres URL wygląda następująco:
```
https://preview.flow.microsoft.com/manage/environments/839eace6-59ab-4243-97ec-a5b8fcc104e7/flows/6df8ec2d-3a2b-49ef-8e91-942b8be3202t/details
```
Identyfikator GUID po environments/ jest EnvironmentName, a identyfikator GUID po flows/ to FlowName

W przypadku przepływu rozwiązania adres URL wygląda następująco:

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

Identyfikator GUID po environments/ jest EnvironmentName, a identyfikator GUID po flows/ to FlowName

Nazwę aplikacji AppName dla kanwy można znaleźć na stronie szczegółów aplikacji kanw.
AppName dla aplikacji opartej na modelu można znaleźć w eksploratorze rozwiązań.
Aby wyświetlić przykłady, wpisz: get-help Add-AdminFlowPowerAppContext -examples.
Aby uzyskać więcej informacji, wpisz get-help Add-AdminFlowPowerAppContext -detailed.
Aby uzyskać informacje techniczne, wpisz get-help Add-AdminFlowPowerAppContext -full.

Usuwanie przepływów w kontekście aplikacji

Usuń zależność między przepływami a aplikacją za pomocą tego polecenia PowerShell. Polecenie Remove-AdminFlowPowerAppContext usuwa kontekst aplikacji z określonego przepływu.

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

Polecenia Power Automate

Te ważne polecenia należy stosować do wykonywania czynności administracyjnych związanych z Power Automate.

Aby uzyskać pełną listę poleceń cmdlets programu Power Automate i Power Apps dla administratorów, zobacz Wprowadzenie do programu PowerShell dla administratorów Power Platform.

Wyświetl wszystkie przepływy

Get-AdminFlow

Zwraca listę wszystkich przepływów w dzierżawie.

Wyświetl szczegóły roli właściciela przepływu

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

Zwraca szczegółowe informacje o właścicielu określonego przepływu.

Uwaga

tak jak w przypadku środowisk i usługi PowerApps, pole FlowName zawiera unikatowy identyfikator (identyfikator GUID), który jest inny niż nazwa wyświetlana przepływu.

Wyświetl szczegóły dotyczące użytkownika przepływu

Get-AdminFlowUserDetails –UserId $Global:currentSession.userId

Zwraca szczegółowe informacje użytkownika dotyczące wykorzystania przepływu. W tym przykładzie użyto identyfikatora użytkownika obecnie zalogowanego użytkownika sesji PowerShell jako danych wejściowych.

Usuń szczegóły dotyczące użytkownika przepływu

Remove-AdminFlowUserDetails –UserId 'UserId'

Całkowicie usuwa szczegóły dotyczące użytkownika przepływu z bazy danych firmy Microsoft. Wszystkie przepływy użytkownika wejściowego należy usunąć, aby można było wyczyścić szczegóły użytkownika przepływu.

Uwaga

Pole UserId jest identyfikatorem obiektu rekordu Microsoft Entra użytkownika, który można znaleźć w Azure Portal w sekcji Tożsamość Microsoft Entra>Użytkownicy>Profil>Identyfikator obiektu. Aby uzyskać dostęp do tych danych, należy mieć uprawnienia administratora.

Eksportowanie wszystkich przepływów do pliku CSV

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

Powoduje wyeksportowanie wszystkich przepływów z Twojej dzierżawy do pliku widoku tabelarycznego csv.

Dodawanie przepływów do rozwiązań Dataverse

Add-AdminFlowsToSolution -EnvironmentName <String>

Migruje wszystkie przepływy bez rozwiązań w środowisku.

Odmiany parametrów mogą być używane do migrowania tylko określonych przepływów, dodawania do określonego rozwiązania lub migrowania tylko określonej liczby przepływów jednocześnie.

Aby uzyskać szczegółowe informacje techniczne, zobacz Add-AdminFlowsToSolution.

Polecenia połączenia interfejsu API

Wyświetlanie połączeń interfejsu API w dzierżawie i zarządzanie nimi.

Wyświetl wszystkie połączenia natywne w środowisku domyślnym

Get-AdminPowerAppEnvironment -Default | Get-AdminPowerAppConnection

Powoduje wyświetlenie listy wszystkich połączeń interfejsu API dostępnych w środowisku domyślnym. Połączenia natywne znajdują się na karcie Dataverse>Połączenia w Power Apps.

Wyświetl wszystkie niestandardowe łączniki w dzierżawie

Get-AdminPowerAppConnector

Zwraca listę wszystkich szczegółów niestandardowych łączników w dzierżawie.

Uwaga

Get-AdminPowerAppConnector nie ma listy łączników niestandardowych dostępnych w rozwiązaniu. To znane ograniczenie.

Komendy zasad ochrony przed utratą danych (DLP)

Te polecenia cmdlet pozwalają sterować zasadami DLP w dzierżawie.

Tworzenie zasad DLP

New-DlpPolicy

Tworzy nową zasadę DLP dla dzierżawy zalogowanego administratora.

Pobieranie listy obiektów DLP

Get-DlpPolicy

Pobiera nową zasadę DLP dla dzierżawy zalogowanego administratora.

Uwaga

Podczas wyświetlania zasad DLP za pomocą programu PowerShell łączniki wyświetlana nazwa od utworzenia zasad DLP lub ostatniego przenoszonych łączników w ramach zasad. Nowe zmiany nazw wyświetlanych łączników nie zostaną odzwierciedlone.
Podczas wyświetlania zasad DLP za pomocą programu PowerShell nowe łączniki w grupie domyślnej, które nie zostały przeniesione, nie zostaną zwrócone.

W przypadku obu tych znanych problemów obejściem ich jest przeniesienie łącznika do innej grupy zasad, a następnie przeniesienie go z powrotem do odpowiedniej grupy. Po wykonaniu tego działania każdy z łączników będzie widoczny z ich prawidłową nazwą.

Aktualizacja zasady DLP

Set-DlpPolicy

Aktualizuje szczegóły zasady, takie jak wyświetlana nazwa.

Usuwanie zasady

Remove-DlpPolicy

Usuwa zasadę DLP.

Polecenia cmdlet wyjątku zasobu DLP

Te polecenia cmdlet umożliwiają wyłączenie lub cofnięcie wyłączenia określonych zasobów z zasad DLP.

Pobieranie listy zasobów objętych wyłączeniem dla zasad DLP

Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName

Tworzenie nowej listy zasobów objętych wyłączeniem dla zasad DLP

New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources

Aktualizowanie listy zasobów objętych wyłączeniem dla zasad DLP

Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources

Usuwanie listy zasobów objętych wyłączeniem dla zasad DLP

Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName

Aby wyłączyć zasób z zasad DLP, potrzebne są następujące informacje:

Identyfikator dzierżawcy (GUID)
Identyfikator zasad DLP (GUID)
Identyfikator zasobu (kończy się identyfikatorem GUID)
Typ zasobu

Identyfikator i typ zasobu można pobrać, korzystając z poleceń cmdlet Get-PowerApp dla aplikacji oraz Get-Flow dla przepływów w PowerShell .

Przykładowy skrypt usuwania

Aby wyłączyć przepływ w identyfikatorem f239652e-dd38-4826-a1de-90a2aea584d9 i aplikację z identyfikatorem 06002625-7154-4417-996e-21d7a60ad624, można uruchomić następujące polecenia 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 b1c07da8-2ae2-47e7-91b8-d3418892f507 -PolicyName 65da474a-70aa-4a59-9ae1-65a2bebbf98a -NewDlpPolicyExemptResources $exemptResources 
15. 
16. exemptResources 
17. --------------- 
18. {@{id=/providers/Microsoft.ProcessSimple/environments/Default-b1c07da8-2ae2-47e7-91b8-d3418892f507/flows/f239652e-dd38-4826-a1de-90a2aea584d9; type=Microsoft.ProcessSimple/environments/flows}, @{id=/providers/Microsoft.PowerApps/apps/06002625-7154-4417-996e-21d7a60ad..

Doświadczenie zwolnienia z DLP w następujących scenariuszach

#	Scenariusz	Środowisko
1	Użytkownik uruchamia aplikację, która nie jest zgodna z programem DLP, ale jest wykluczona z programu DLP.	Uruchamianie aplikacji odbywa się z lub bez egzekwowania DLP.
2	Twórca zapisuje aplikację, która nie jest zgodna z programem DLP, ale jest wykluczona z programu DLP	Zgodność z DLP ze zwolnienie DLP lub bez niego nie blokuje operacji zapisywania aplikacji. Ostrzeżenie o niezgodności DLP jest wyświetlane niezależnie od przechowania danych przez program DLP.
3	Twórca zapisuje przepływ, który nie jest zgodna z programem DLP, ale jest wykluczony z programu DLP	Zgodność z DLP ze zwolnienie DLP lub bez niego nie blokuje operacji zapisywania przepływu. Ostrzeżenie dotyczące niezgodności z DLP nie jest wyświetlane.

Zobacz polecenia komunikatów o błędach nadzoru

Następująca tabela może poprowadzić użytkowników końcowych do materiałów referencyjnych dotyczących struktury organizacyjnej. Polecenie zawiera łącze do dokumentacji nadzoru oraz kontakt w sytuacji, gdy zostanie wyświetlony monit formantów z danymi użytkownika. Jeśli na przykład jest ustawiona zawartość komunikatów o błędach ładu funkcji, jest ona wyświetlana w komunikatach dotyczących wymuszania ochrony przed utratą danych Power Apps.

Zobacz polecenia komunikatów o błędach nadzoru

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

Adres URL wiadomości o błędzie nadzoru i adres e-mail błędu można wyświetlać niezależnie lub razem. W polu enabled można włączyć lub wyłączyć komunikat o błędzie pochyłych.

Zobacz scenariusze komunikatów o błędach nadzoru

#	Scenariusz	Dostępność
1	Użytkownik uruchamia aplikację utworzoną za pomocą Power Apps, która nie jest zgodna z DLP	Ogólna dostępność
2	Twórca udostępnia aplikację kanwy Power Apps, ale nie ma uprawnienia do udostępniania	Ogólna dostępność
3	Twórca udostępnia aplikację kanwy Power Apps z pozycją Wszyscy, ale nie ma uprawnień do udostępniania wszystkim	Ogólna dostępność
4	Twórca zapisuje aplikację utworzoną za pomocą Power Apps, która nie jest zgodna z DLP	Ogólna dostępność
5	Twórca zapisuje przepływ Power Automate, który nie jest zgodny z DLP	Ogólna dostępność
6	Użytkownik uruchamia aplikację bez członkostwa w grupie zabezpieczeń skojarzonej ze środowiskiem Dataverse	Ogólna dostępność

Wyświetl treść komunikatu o błędach nadzoru

Get-PowerAppDlpErrorSettings -TenantId 'TenantId'

Aktualizuj treść komunikatu o błędach nadzoru

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

Wymuszanie zasad DLP dla naruszających połączeń — środowisko

Te polecenia umożliwiają wymuszanie zasad DLP dla naruszających połączeń na poziomie środowiska lub dzierżawy.

Wymuszanie zasad DLP dla naruszających połączeń

Wymuszasz zasady DLP dla połączeń w środowisku. Spowoduje to wyłączenie istniejących połączeń, które uniemożliwią obsługę zasad DLP, oraz włączenie wcześniej wyłączonych połączeń, które nie mają już żadnych zasad DLP.

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName [Environment ID]

Przykładowy skrypt wymuszania środowiska

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

Wymuszanie zasad DLP dla naruszających połączeń — dzierżawca

Wymuś zasady DLP dla połączeń w dzierżawie. Spowoduje to wyłączenie istniejących połączeń, które uniemożliwią obsługę zasad DLP, oraz włączenie wcześniej wyłączonych połączeń, które nie mają już żadnych zasad DLP.

Start-DLPEnforcementOnConnectionsInTenant

Polecenia Blokuj licencje wersji próbnej

Polecenia:

Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans

Polecenia cmdlet dozwolonych planów zgody mogą służyć do dodawania lub usuwania dostępu do określonego typu planu zgody przez dzierżawcę. Plany zgody „wewnętrznej” to licencje wersji próbnej lub planów dla deweloperów, w których użytkownicy mogą rejestrować się za pośrednictwem portali usług Power Apps/Power Automate/Power Automate for desktop. Plany wyrażania zgody na subskrypcję ad-hoc lub subskrypcję „Ad hoc” to licencje próbne, w których użytkownicy mogą się samodzielnie zarejestrować na https://signup.microsoft.com. Administratorzy mogą przypisywać użytkowników za pomocą Tożsamości Microsoft Entra lub portalu administracyjnego Microsoft 365.

Domyślnie w dzierżawie jest dozwolony każdy typ planu zgody. Jednak administrator Power Platform może zablokować użytkownikom przypisywanie sobie licencji próbnych, ale zachowuje możliwość przypisywania licencji próbnych w imieniu użytkowników. Można do tego użyć polecenia Remove-AllowedConsentPlans -Types "Internal" i wyłączyć ustawienie AllowAdHocSubscriptions w usłudze tożsamość Microsoft Entra.

Ważne

Należy pamiętać, że podczas używania polecenia Remove-AllowedConsentPlans wszystkie istniejące plany określonego typu są usuwane ze wszystkich użytkowników w dzierżawcy i nie można ich odzyskać. To polecenie blokuje wszystkie przyszłe przypisania tego typu. Jeśli administrator Power Platform będzie chciał ponownie włączyć plany tego typu, może go użyć Add-AllowedConsentPlans. Aby wyświetlić bieżący stan dozwolonych planów wyrażania zgody, mogą ich użyć Get-AllowedConsentPlans.

W razie pytań

Jeśli masz komentarze, sugestie lub pytania, opublikuj je na Forum Aministrowania Power Apps.

Zobacz też

Wprowadzenie do korzystania z modułu administratora programu Power Apps.
Microsoft.PowerApps.Administration.PowerShell
Przegląd: Programowalność i rozszerzanie

Obsługa PowerShell dla Power Apps i Power Automate

Polecenia cmdlet

Wprowadzenie do programu PowerShell

Wymagania wstępne

Instalacja modułu

Aktualizacje modułu

Polecenia cmdlet Power Apps dla twórców aplikacji

Wymagania wstępne

Lista poleceń cmdlet — polecenia cmdlet Kreatora

Polecenia cmdlet Power Apps dla administratorów

Wskazówki

Przykłady operacji

Polecenia dotyczące środowisk

Zostanie wyświetlona lista wszystkich środowisk.

Wyświetlanie szczegółowych informacji o domyślnym środowisku użytkownika

Wyświetl szczegóły określonego środowiska

Polecenia Power Apps

Wyświetl listę wszystkich Power Apps

Wyświetlanie listy wszystkich Power Apps odpowiadających danym nazwom wejściowym

Poleć aplikację

Tworzenie aplikacji jako aplikacji głównej przy użyciu potoku

Wyświetlanie liczby aplikacji, których właścicielem jest każdy użytkownik

Wyświetlanie liczby aplikacji w każdym środowisku

Pobierz szczegóły użytkownika Power Apps

Eksportowanie listy przydzielonych licencji użytkownika

Ustawianie zalogowanego użytkownika jako właściciela aplikacji kanwy

Wyświetlanie listy usuniętych aplikacji kanwy w środowisku

Odzyskiwanie usuniętej aplikacji kanwy

Wyznaczanie środowiska niestandardowych formularzy programu SharePoint

Ustawienie wyświetlania ustawień dzierżawy w celu udostępniania aplikacji Wszyscy

Zmiana ustawienia wyświetlania ustawień dzierżawy w celu udostępniania aplikacji Wszyscy

Powierzchnia zawartości komunikatu o błędzie w błąd w organizacji

Dołączanie przepływów kontekstowych do aplikacji

Usuwanie przepływów w kontekście aplikacji

Polecenia Power Automate

Wyświetl wszystkie przepływy

Wyświetl szczegóły roli właściciela przepływu

Wyświetl szczegóły dotyczące użytkownika przepływu

Usuń szczegóły dotyczące użytkownika przepływu

Eksportowanie wszystkich przepływów do pliku CSV

Dodawanie przepływów do rozwiązań Dataverse

Polecenia połączenia interfejsu API

Wyświetl wszystkie połączenia natywne w środowisku domyślnym

Wyświetl wszystkie niestandardowe łączniki w dzierżawie

Komendy zasad ochrony przed utratą danych (DLP)

Tworzenie zasad DLP

Pobieranie listy obiektów DLP

Aktualizacja zasady DLP

Usuwanie zasady

Polecenia cmdlet wyjątku zasobu DLP

Pobieranie listy zasobów objętych wyłączeniem dla zasad DLP

Tworzenie nowej listy zasobów objętych wyłączeniem dla zasad DLP

Aktualizowanie listy zasobów objętych wyłączeniem dla zasad DLP

Usuwanie listy zasobów objętych wyłączeniem dla zasad DLP

Przykładowy skrypt usuwania

Doświadczenie zwolnienia z DLP w następujących scenariuszach

Zobacz polecenia komunikatów o błędach nadzoru

Zobacz polecenia komunikatów o błędach nadzoru

Zobacz scenariusze komunikatów o błędach nadzoru

Wyświetl treść komunikatu o błędach nadzoru

Aktualizuj treść komunikatu o błędach nadzoru

Wymuszanie zasad DLP dla naruszających połączeń — środowisko

Wymuszanie zasad DLP dla naruszających połączeń

Przykładowy skrypt wymuszania środowiska

Wymuszanie zasad DLP dla naruszających połączeń — dzierżawca

Polecenia Blokuj licencje wersji próbnej

W razie pytań

Zobacz też

Dodatkowe zasoby