Obsługa PowerShell dla Power Apps i Power Automate

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ą obecnie możliwe tylko ręcznie w Power AppsPower Automate lub centrum administracyjnym Power Platform .

Polecenia cmdlet

Polecenia cmdlet to funkcje napisane w języku skryptowym PowerShell , które wykonują polecenia w języku 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:

• Administrator
• Maker

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.

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 dotyczące programu PowerShell

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 i logowanie

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

1. Uruchom program Powershell jako Administrator.

   

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

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

   

4. Opcjonalnie przed uzyskaniem dostępu do poleceń możesz podać swoje poświadczenia. Poświadczenia są odświeżane przez około osiem godzin, zanim zaistnieje konieczność ponownego zalogowania się. Jeśli poświadczenia nie zostaną podane przed wykonaniem polecenia, zostanie wyświetlony monit o poświadczenia.

   # 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. Opcjonalnie można określić określony punkt końcowy. Domyślny punkt końcowy to prod. Jeśli użytkownik chce uruchomić skrypt PowerShell przeznaczony dla środowiska w regionie nieprodukcyjnym, takim jak GCC, parametr -Endpoint można zmienić na usgov dla GCC Moderate lub usgovhigh for GCC High, lub dod dla GCC DOD. Pełna lista obsługiwanych punktów końcowych to: "prod,wersja zapoznawcza,tip1,tip2,usgov,usgov,usgov,dod,china".

   # An environment in another region, such as GCC, can be targeted using the -Endpoint parameter.
   Add-PowerAppsAccount -Endpoint "usgov" 
   

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 dotyczące poleceń cmdlet usługi Power Apps

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

Zaktualizowaliśmy niektóre nazwy funkcji poleceń cmdlet w najnowszej wersji, aby dodać odpowiednie prefiksy, aby zapobiec kolizjom. Aby zapoznać się z omówieniem zmian, zapoznaj się z poniższą tabelą.

Purpose	Polecenia cmdlet
Dodaj aplikację kanwy do rozwiązania Microsoft Dataverse	Set-PowerAppAsSolutionAware
Odczytuj i aktualizuj środowiska	Get-AdminPowerAppEnvironment(wcześniej Get-PowerAppsEnvironment) Get-FlowEnvironment Restore-PowerAppEnvironment(wcześniej Restore-AppVersion)
Odczytuj, aktualizuj i usuwaj aplikację kanwy	Get-AdminPowerApp(wcześniej Get-App) Remove-AdminPowerApp(wcześniej 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 Set-ConnectionRoleAssignment) Remove-AdminPowerAppConnectionRoleAssignment(wcześniej Remove-ConnectionRoleAssignment)
Odczyt i usuwanie łączników	Get-AdminPowerAppConnector(wcześniej Get-Connector) Remove-AdminPowerAppConnector(wcześniej Remove-Connector)
Uprawnienia do dodawania, odczytu, aktualizacji i usuwania łączników niestandardowych	Get-AdminPowerAppConnectorRoleAssignment(wcześniej Get-ConnectorRoleAssignment) Get-PowerAppConnectorRoleAssignment(wcześniej Set-ConnectorRoleAssignment) Remove-PowerAppConnectorRoleAssignment(wcześniej 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 Nowa-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 środowisk
• Power Apps Polecenia
• Power Automate Polecenia
• Polecenia połączenia API
• Polecenia zasad danych
• Polecenia cmdlet wykluczania zasobów danych
• Polecenia Blokuj licencje próbne

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

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

Aplikacja musi już być polecaną aplikacją, zanim zostanie zmieniona na element Hero.

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.

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

Pobierz szczegóły użytkownika Power Apps

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

Poprzednie polecenie przechowuje szczegóły użytkownika usługi Power Apps (podstawowe informacje o użyciu użytkownika wejściowego za pośrednictwem głównej nazwy 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

Dane wyjściowe polecenia cmdlet Get-AdminPowerAppLicenses obejmują tylko licencje dla użytkowników, którzy uzyskiwali dostęp do usług Power Platform (na przykład Power Apps, Power Automate lub Centrum administracyjne platformy Power Platform). Użytkownicy, którzy mieli licencje przypisane w identyfikatorze Entra firmy Microsoft (zazwyczaj za pośrednictwem centrum administracyjnego platformy Microsoft 365), ale nigdy nie uzyskiwali dostępu do usług platformy Power Platform, nie mają licencji uwzględnionych w wygenerowanych danych wyjściowych .csv. Ponadto, ponieważ usługi licencjonowania platformy Power Platform buforuje licencje, aktualizacje wprowadzone do przypisań licencji w identyfikatorze Entra firmy Microsoft mogą potrwać do siedmiu dni, aby odzwierciedlić dane wyjściowe dla użytkowników, którzy ostatnio nie mieli 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 Power App na bieżącego użytkownika i zastępuje pierwotnego właściciela jako rolę typu "może wyświetlać".

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.

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

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

Zmiana ustawienia wyświetlania ustawień dzierżawy w celu udostępniania aplikacji 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.

Wyświetlanie listy przepływów akcji HTTP

Get-AdminFlowWithHttpAction -EnvironmentName <String>

Wyświetla listę przepływów z akcjami HTTP.

Nazwa wyświetlana	FlowName	NazwaŚrodowiska
Pobieranie faktury HTTP	flow-1	environment-1
Płatność za fakturę z aplikacji	flow-2	environment-2
Uzgadnianie konta	flow-3	environment-3

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 wyświetla listy łączników niestandardowych, które znajdują się w rozwiązaniu. To znane ograniczenie.

Polecenia zasad danych

Te polecenia cmdlet kontrolują zasady danych w dzierżawie.

Tworzenie zasad danych

New-DlpPolicy

Tworzy nowe zasady danych dla dzierżawy zalogowanego administratora.

Pobieranie listy obiektów zasad danych

Get-DlpPolicy

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

Uwaga

• Podczas wyświetlania zasad danych przy użyciu programu PowerShell nazwa wyświetlana łączników pochodzi od momentu utworzenia zasad danych lub ostatniego przeniesienia łączników w ramach zasad. Nowe zmiany nazw wyświetlanych łączników nie są odzwierciedlane.
• Podczas wyświetlania zasad danych przy użyciu programu PowerShell nowe łączniki w grupie domyślnej, które nie zostały przeniesione, nie są zwracane.

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 tej czynności każdy z łączników jest widoczny z poprawną nazwą.

Aktualizowanie zasad danych

Set-DlpPolicy

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

Usuwanie zasady

Remove-DlpPolicy

Usuwa zasady danych.

Polecenia cmdlet wykluczania zasobów danych

Te polecenia cmdlet umożliwiają wykluczenie lub wyłączenie określonego zasobu z zasad.

Pobieranie istniejącej listy zasobów wykluczonych dla zasad danych

Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Tworzenie nowej listy zasobów wykluczonych dla zasad danych

New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources 

Aktualizowanie listy wykluczonych zasobów dla zasad danych

Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources 

Usuwanie listy wykluczonych zasobów dla zasad danych

Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Aby wykluczyć zasób z zasad danych, potrzebne są następujące informacje:

• Identyfikator dzierżawcy (GUID)
• Identyfikator zasad danych (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 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.. 

Środowisko wykluczania zasad danych w następujących scenariuszach

#	Scenariusz	Środowisko
1	Użytkownik uruchamia aplikację, która nie jest zgodna z zasadami danych, ale zwalnia zasady danych.	Uruchamianie aplikacji jest kontynuowane lub bez wymuszania zasad danych.
2	Twórca zapisuje aplikację, która nie jest zgodna z zasadami danych, ale zasady danych wykluczone	W przypadku wykluczenia z zasadami danych zgodność zasad danych nie blokuje operacji zapisywania aplikacji. Ostrzeżenie o niezgodności zasad danych jest wyświetlane niezależnie od wykluczenia zasad danych.
3	Twórca zapisuje przepływ, który nie jest zgodny z zasadami danych, ale zasady danych wykluczone	W przypadku wykluczenia z zasadami danych zgodność zasad danych nie blokuje operacji zapisywania przepływu. Ostrzeżenie o niezgodności zasad danych 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. Na przykład po ustawieniu zawartości komunikatu o błędzie ładu jest wyświetlana w komunikatach wymuszania środowiska uruchomieniowego zasad danych usługi 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ą przy użyciu usługi Power Apps, która nie jest zgodna z zasadami danych	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ą przy użyciu usługi Power Apps, która nie jest zgodna z zasadami danych	Ogólna dostępność
5	Twórca zapisuje przepływ usługi Power Automate, który nie jest zgodny z zasadami danych	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 danych w przypadku naruszenia połączeń — środowisko

Te polecenia cmdlet umożliwiają wymuszanie zasad danych w celu naruszenia połączeń na poziomie środowiska lub dzierżawy.

Wymuszanie zasad danych w przypadku naruszenia połączeń

Zasady danych można wymusić na połączeniach w środowisku. Wymuszanie wyłącza istniejące połączenia naruszające zasady danych i włącza wszystkie wcześniej wyłączone połączenia, które nie naruszają już zasad danych.

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName [Environment ID]

Przykładowy skrypt wymuszania środowiska

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

Wymuszanie zasad danych w przypadku naruszenia połączeń — dzierżawa

Zasady danych można wymusić na połączeniach w dzierżawie. Wymuszanie wyłącza istniejące połączenia naruszające zasady danych i włącza wszystkie wcześniej wyłączone połączenia, które nie naruszają już zasad danych.

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 wszystkie typy planów zgody są dozwolone w dzierżawie. Jednak administrator platformy Power Platform może chcieć zablokować użytkownikom przypisywanie sobie licencji próbnych, ale zachować możliwość przypisywania licencji próbnych w imieniu użytkowników. Tę regułę można wykonać za pomocą Remove-AllowedConsentPlans -Types "Internal" polecenia i nie zezwalając na ustawienie Update-MgPolicyAuthorizationPolicy -AllowedToSignUpEmailBasedSubscriptions w identyfikatorze Entra firmy Microsoft.

Ważne

W przypadku używania programu Remove-AllowedConsentPlanswszystkie istniejące plany określonego typu są usuwane ze wszystkich użytkowników w dzierżawie 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 tablicy społeczności Administrowanie usługą Power Apps.

Informacje pokrewne

• Rozpocznij korzystanie z modułu administratora Power Apps .
  
• Microsoft.PowerApps. Administracja.PowerShell
  
• wersja zapoznawcza: Omówienie możliwości programowania i rozszerzalności