Power Apps және Power Automate үшін PowerShell қолдауы

PowerShell құрушылар мен әкімшілерге арналған Power Platform комдлеттері арқылы көптеген бақылау және басқару тапсырмаларын автоматтандыруға болады. Бүгінгі таңда қолменPower Apps, Power Automate немесе Power Platform әкімшілік орталығында-де ғана мүмкін тапсырмалар.

Командлеттер

Командлеттер бұл PowerShell пәрмендерін орындайтын PowerShell скрипт тілінде жазылған функциялар. Бұл Power Apps cmdlet-терін іске қосу арқылы сіздің Business Application Platform-ыңызбен веб-браузердегі әкімшілік портал арқылы өтпей-ақ өзара әрекеттесуге мүмкіндік береді.

Жұмыс процесін оңтайландыратын күрделі сценарийлерді жазу үшін командлеттерді басқа PowerShell функцияларымен біріктіруге болады. Жалға алушыда әкімші болмасаңыз, бірақ сізге тиесілі ресурстармен шектелсеңіз, командлеттерді әлі де пайдалана аласыз. Әкімшілік пайдаланушы тіркелгісі Admin деп басталатын командлеттерді пайдаланады.

Командлеттер PowerShell галереясында екі бөлек модуль ретінде қолжетімді:

• Әкімші
• Жасаушы

Power Apps әкімшілік модулі туралы ақпарат алу үшін Power Apps әкімшілік модулін пайдалануды бастау және Microsoft.PowerApps.Administration.PowerShell бөлімдерін қараңыз.

PowerShell қолданбасын бастаңыз

Егер сіз PowerShell қолданбасын жаңадан бастасаңыз және оны табу және іске қосу бойынша көмек қажет болса, PowerShell-пен жұмысты бастау бөліміне өтіңіз. PowerShell немесе командлеттерді пайдалану бойынша көмек қажет болса, PowerShell анықтамалық жүйесі бөліміне өтіңіз.

PowerShell бағдарламасының алғышарттары

Бұл мақалада PowerShell Windows PowerShell 5.x нұсқасын талап етеді. Компьютерде іске қосылған PowerShell нұсқасын тексеру үшін келесі пәрменді іске қосыңыз:

$PSVersionTable.PSVersion

Егер ескірген нұсқаңыз болса, Upgrading бар Windows PowerShell сайтына кіріңіз.

Маңызды

Бұл құжатта сипатталған модульдер .NET Framework қолданады, ол PowerShell 6.0 және одан кейінгі нұсқалармен үйлесімсіз. Бұл кейінгі нұсқалар .NET ядросын қолданады.

Модульді орнату және жүйеге кіру

Қолданба жасаушыларға арналған PowerShell командлеттерін іске қосу үшін:

1. PowerShell командлетін әкімші ретінде іске қосыңыз.

   

2. Қажетті модульдерді импорттаңыз.

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

   Немесе, компьютерде әкімші құқықтарыңыз болмаса, орнату үшін -Scope CurrentUser параметрін пайдаланыңыз.

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

3. Репозиторийдің InstallationPolicy мәніне өзгертуді қабылдау сұралса, [A] Yes Aбарлық модульдерге қабылдаңыз. >, содан кейін әр модуль үшін Enter түймешігін басыңыз.

   

4. Қосымша пәрмендерге қол жеткізбес бұрын тіркелгі деректерін бере аласыз. Жүйеге қайта кіру талап етілмес бұрын тіркелгі деректері сегіз сағатқа дейін жаңартылады. Егер пәрмен орындалмас бұрын тіркелгі деректері берілмесе, тіркелгі деректеріне шақыру пайда болады.

   # 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. Қосымша түрде, белгілі бір соңғы нүкте мақсатты болуы мүмкін. Әдепкі соңғы нүкте prod болып табылады. Егер пайдаланушы GCC сияқты өндірістік емес аймақтағы ортаға бағытталған PowerShell скрипті іске қосқысы келсе, параметрді -Endpoint GCC Moderate, usgov GCC High немесе usgovhigh GCC DOD үшін dod өзгертуге болады. Қолдау көрсетілетін соңғы нүктелердің толық тізімі: "prod,алдын ала қарау нұсқасы,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" 
   

Модуль жаңартулары

Барлық PowerShell модульдерінің нұсқасын Get-Module арқылы тексеруге болады.

Get-Module

Және барлық PowerShell модульдерін Жаңарту модулі арқылы ең соңғысына жаңартуға болады.

Update-Module

Балама түрде Power Platform Get-Module және параметрін пайдаланып, -Name модульдер нұсқасын тексеріңіз.

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

Power Platform PowerShell модульдерін Жаңарту модулі және -Name параметрін пайдаланып жаңартыңыз.

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

Power Apps cmdlet-тері қосымша жасаушыларға арналған

Prerequisites for Power Apps cmdlets

Жарамды Power Apps лицензиясы бар пайдаланушылар осы cmdlet-терде операцияларды орындай алады. Дегенмен, олар жасалған немесе ортақ пайдаланылатын қолданбалар мен ағындар сияқты ресурстарға ғана қол жеткізе алады.

Командлет тізімі - Жасаушы командлеттері

Ескертпе

Біз соңғы шығарылымдағы командлеттердің кейбір функция атауларын жаңарттық, бұл соқтығысудың алдын алу үшін тиісті префикстерді қосу үшін. Өзгергені туралы шолу үшін келесі кестені қараңыз.

Мақсат	Командлет
Microsoft Dataverse шешіміне Canvas қосымшасын қосу	Set-PowerAppAsSolutionAware
Орталарды оқу және жаңарту	Get-AdminPowerAppEnvironment(бұрынғы Get-PowerAppsEnvironment) Get-FlowEnvironment Restore-PowerAppEnvironment(бұрын Restore-AppVersion)
Кенеп бағдарламасын оқу, жаңарту және жою	Get-AdminPowerApp(бұрын Get-App) Remove-AdminPowerApp(бұрынғы Remove-App) Publish-AdminPowerApp (алдыңғы Publish-App)
Кенеп бағдарламасының рұқсаттарын оқу, жаңарту және жою	Get-AdminPowerAppRoleAssignment(бұрынғы Get-AppRoleAssignment) Remove-AdminPowerAppRoleAssignment(бұрын Remove-AppRoleAssignment)
Ағынды оқу, жаңарту және жою	Get-AdminFlow Enable-AdminFlow Өшіру - AdminFlow Жою-AdminFlow
Ағын рұқсаттарын оқу, жаңарту және жою	Get-AdminFlowOwnerRole Set-AdminFlowOwnerRole Жою-AdminFlowOwnerRole
Ағын растауларын оқу және жауап беру	Get-AdminFlowApprovalRequest Жою-AdminFlowApprovals
Қосылымдарды оқу және жою	Get-AdminPowerAppConnection(бұрынғы Get-Connection) Remove-AdminPowerAppConnection(бұрынғы Remove-Connection)
Қосылым рұқсаттарын оқу, жаңарту және жою	Get-AdminPowerAppConnectionRoleAssignment(бұрынғы Get-ConnectionRoleAssignment) Set-AdminPowerAppConnectionRoleAssignment(бұрын Set-ConnectionRoleAssignment) Remove-AdminPowerAppConnectionRoleAssignment(бұрын Remove-ConnectionRoleAssignment)
Қосқыштарды оқу және жою	Get-AdminPowerAppConnector(бұрынғы Get-Connector) Remove-AdminPowerAppConnector(бұрын Remove-Connector)
Реттелетін қосқыш рұқсаттарын қосу, оқу, жаңарту және жою	Get-AdminPowerAppConnectorRoleAssignment(бұрынғы Get-ConnectorRoleAssignment) Get-PowerAppConnectorRoleAssignment(бұрын Set-ConnectorRoleAssignment) Remove-PowerAppConnectorRoleAssignment(бұрын Remove-ConnectorRoleAssignment)
Саясат URL мекенжайларын оқу, қосу және жою	Get-PowerAppPolicyUrlPatterns New-PowerAppPolicyUrlPatterns Remove-PowerAppPolicyUrlPatterns
Басқару бағдарламаларын оқу, тіркеу және жою	Get-PowerAppManagementApp Get-PowerAppManagementApps Жаңа-PowerAppManagementApp Жою-PowerAppManagementApp
Қорғаныс кілттерін оқу, жасау, жаңарту және импорттау	Get-PowerAppRetrieveAvailableTenantProtectionKeys Get-PowerAppGenerateProtectionKey Get-PowerAppRetrieveTenantProtectionKey New-PowerAppImportProtectionKey Set-PowerAppTenantProtectionKey

Power Apps cmdlets for administrators

Әкімшілерге арналған Power Apps және Power Automate cmdlet-тер туралы толығырақ ақпарат алу үшін PowerShell for Power Platform Administrators бөлімін қараңыз.

Кеңестер

• Мысалдар тізімін алу үшін Get-Help артынан a CmdletName қолданыңыз.

  

• сызықша - тергеннен кейін кіріс тегтерін айналдыру үшін Tab басуға болады. Бұл жалаушаны командлет атынан кейін қойыңыз.

Пәрмендер мысалы:

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

Операция мысалдары

Төменде жаңа және бар Power Apps cmdlet-терін қалай қолдануға болатынын көрсететін бірнеше жиі кездесетін сценарийлер берілген.

• Қоршаған орта командалары
• Power Apps Командалар
• Power Automate командалар
• API қосылым командалары
• Деректер саясаты пәрмендері
• Деректер ресурстарынан босату cmdlets
• Сынақ лицензияларының пәрмендерін блоктау

Орталар пәрмендері

Бұл пәрмендерді қатысушыдағы орта туралы мәліметтер алу және жаңарту үшін пайдаланыңыз.

Барлық орталар тізімін көрсету

Get-AdminPowerAppEnvironment

Жалға алушыдағы әрбір ортаның тізімін, әрқайсысының мәліметтерімен (мысалы, орта аты (нұсқаулық), көрсетілетін атау, орын, жасаушы және т.б.) қайтарады.

Әдепкі ортаның мәліметтерін көрсету

Get-AdminPowerAppEnvironment –Default

Қатысушының әдепкі ортасы үшін ғана мәліметтерді қайтарады.

Нақты ортаның мәліметтерін көрсету

Get-AdminPowerAppEnvironment –EnvironmentName 'EnvironmentName'

Ескертпе

EnvironmentName өрісі бірегей идентификатор болып табылады, ол DisplayName ден өзгеше (бірінші және екінші өрістерді қараңыз). келесі суретте шығарылады).

Power Apps commands

Бұл операциялар сіздің жалға алушыдағы Power Apps деректерін оқу және өзгерту үшін қолданылады.

Барлық Power Apps тізімін көрсету

Get-AdminPowerApp

Жалға алушы барлық Power Apps тізімін қайтарады, әрқайсысының егжей-тегжейі (мысалы, қосымша атауы (guid), дисплей атауы, жасаушы және тағы басқалары).

Енгізу дисплей атауына сәйкес келетін барлық Power Apps тізімін көрсетіңіз

Get-AdminPowerApp 'DisplayName'

Бұл команда сіздің tenant-ыңыздағы көрсетілім атауына сәйкес келетін барлық Power Apps-ті көрсетеді.

Ескертпе

Бос орындарды қамтитын кіріс мәндерінің айналасында тырнақшаларды пайдаланыңыз. Мысалы, «Менің қолданба атым» пайдаланыңыз.

Бағдарлама ерекшелігі

Set-AdminPowerAppAsFeatured –AppName 'AppName'

Таңдаулы қосымшалар топталып, Power Apps мобильді ойнатқышында тізімнің басына шығарылады.

Ескертпе

Орталар сияқты, AppName өрісі де DisplayName-тен өзгеше бірегей идентификатор болып табылады. Егер сіз көрсетілетін атауына байланысты операциялар жасағыңыз келсе, кейбір функциялар сізге үдерістер тізбегін пайдалануға мүмкіндік береді (келесі функцияны қараңыз).

Үдерістер тізбегін пайдаланып, бағдарламаны басты бағдарлама етіп жасаңыз

Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero

Hero қосымшасы Power Apps мобильді ойнатқышында тізімнің басында орналасқан. Ол жерде тек бір басты бағдарлама болады.

Екі командлет арасындағы құбыр | таңба бірінші командлеттің шығысын алады және егер функция құбырды орналастыру үшін жазылған болса, оны екіншісінің кіріс мәні ретінде береді.

Ескертпе

Қосымша Hero-ға ауыспас бұрын әлдеқашан ерекшеленген қосымша болуы керек.

Әрбір пайдаланушыға тиесілі бағдарламалардың санын көрсету

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

Сіз PowerShell-дің табиғи функцияларын Power Apps cmdlet-терімен біріктіріп, деректерді одан әрі өңдей аласыз. Бұл жерде біз Get-AdminApp нысанынан жауапты атрибутын (нысан) оқшаулау үшін таңдау функциясын пайдаланамыз. Одан кейін біз жауапты нысанының атауын сол нәтижені басқа функцияға беру арқылы оқшаулаймыз. Соңында таңдау функциясының екінші нәтижесін топ функциясына өткізу әр жауаптының бағдарламаларының санын қамтитын кестені қайтарады.

Әрбір ортада бағдарламалардың санын көрсету

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

Power Apps пайдаланушысы туралы мәліметтерді жүктеу

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

Алдыңғы команда Power Apps пайдаланушысының мәліметтерін (кіріс пайдаланушының негізгі атауы арқылы негізгі пайдалану ақпараты) көрсетілген мәтіндік файлда сақтайды. Ол аты бар файл жоқ болса, жаңа файлды жасайды және ол бұрыннан бар болса, мәтіндік файлды қайта жазады.

Тағайындалған пайдаланушы лицензияларының тізімін экспорттау

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

Tenant-тегі барлық тағайындалған пайдаланушы лицензияларын (Power Apps және Power Automate) кестелік көрініс .csv файлға экспорттайды. Экспортталған файлда өзін-өзі қызмет көрсету, тіркелу, ішкі сынақ жоспарлары және Microsoft Entra ID-ден алынған жоспарлар бар. Ішкі сынақ жоспарлары Microsoft 365 әкімшілік орталығындағы әкімшілерге көрінбейді.

Экспорт Microsoft Power Platform пайдаланушылары көп болғандықтан, біраз уақыт алады.

Ескертпе

Get-AdminPowerAppLicenses cmdlet-тің шығысы тек Power Platform қызметтеріне қол жеткізген пайдаланушыларға арналған лицензияларды қамтиды (мысалы, Power Apps, Power Automate немесе Power Platform әкімшілік орталығы). Лицензиялары Microsoft Entra ID-де (әдетте Microsoft 365 әкімшілік орталығы арқылы) берілген, бірақ Power Platform қызметтеріне ешқашан қол жеткізбеген пайдаланушылардың лицензиялары генерацияланған .csv шығысына енгізілмейді. Сонымен қатар, Power Platform лицензиялау қызметтері лицензияларды кэштейтіндіктен, Microsoft Entra ID-дегі лицензияларды тағайындау жаңартулары қызметке жақында қол жеткізбеген пайдаланушылар үшін нәтижесін көрсету үшін жеті күнге дейін уақыт алуы мүмкін.

Тіркелген пайдаланушыны кенеп бағдарламасының иесі ретінде орнатыңыз

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

Power App иесінің рөлін ағымдағы пайдаланушыға өзгертеді және бастапқы иесін "көре алатын" рөл түрі ретінде ауыстырады.

Ескертпе

AppName және EnvironmentName өрістері көрсетілетін атаулар емес, бірегей идентификаторлар (нұсқаулықтар) болып табылады.

Ортадағы жойылған кенеп бағдарламаларының тізімін көрсетіңіз

Get-AdminDeletedPowerAppsList -EnvironmentName 'EnvironmentName'

Бұл пәрмен жақында жойылған барлық кенеп қолданбаларын көрсетеді, себебі олар әлі де қалпына келтірілуі мүмкін. Қалпына келтіруге болатын ұзақтығы — 28 күн. 28 күннен кейін жойылған кез келген қосымша осы тізімде қайтарылмайды және қалпына келтірілмейді.

Жойылған кенеп бағдарламаларын қалпына келтіріңіз

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

Бұл пәрмен Get-AdminDeletedPowerAppsList командлет арқылы табуға болатын кенеп қолданбасын қалпына келтіреді. Get-AdminDeletedPowerAppsList де көрсетілмеген кез келген кенеп қолданбасын қалпына келтіру мүмкін емес.

SharePoint-тың арнайы форма ортасын белгілеу

Төмендегі cmdlet-тер SharePoint-тың арнайы формалары қай ортада сақталатынын анықтау және тексеру үшін қолданылуы мүмкін, әдепкі ортадан гөрі. SharePoint арнайы формалары үшін арнайы орта өзгергенде, жаңа жасалған арнайы формалар осы орта сақталады. Бұрыннан бар реттелетін пішіндер әртүрлі ортаға автоматты түрде ауыспайды, өйткені бұл командлеттер қолданылады. Белгіленген ортада пайдаланушының реттелетін пішін жасау мүмкіндігі пайдаланушыда орта жасаушысы рөлінің болуын талап етеді. Пайдаланушыларға Power Platform басқару орталығында орта жасаушысы рөлі берілуі мүмкін.

Әдепкі орта болып табылмайтын кез келген орта жойылуы мүмкін. Егер арнайы SharePoint арнайы форма ортасы жойылып қалса, арнайы формалар да сол арқылы жойылады.

Get-AdminPowerAppSharepointFormEnvironment  

Бұл команда жаңа құрылған SharePoint арнайы формаларға арналған орта үшін EnvironmentName мекенжайын қайтарады. Егер орта ешқашан тағайындалмаған болса, әдепкі орта қайтарылады.

Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName' 

Бұл команда жаңа жасалған SharePoint арнайы формаларын сақтайтын ортаны белгілейді, әдепкі ортаның орнына. Бұрыннан бар реттелетін пішіндер жаңадан тағайындалған ортаға автоматты түрде ауыспайды. SharePoint арнайы формалары үшін тек өндірістік орта ғана белгіленеді.

Reset-AdminPowerAppSharepointFormEnvironment  

Бұл әдепкі ортаны SharePoint арнайы формаларын сақтау үшін арнайы орта ретінде қайта орнатады.

Қолданбаларды Барлығымен бөлісу мүмкіндігі үшін жалға алушы параметрін көрсету

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

Бұл параметр орта жасаушы қауіпсіздік рөлі бар пайдаланушылар кенеп қолданбаларын Ұйымдағы әрбірмен бөлісе алатынын бақылайды. Баптау true күйінде орнатылғанда, тек әкімшілік рөлі бар пайдаланушылар (Dynamics 365 әкімші, Power Platform Service әкімшісі Microsoft Entra tenant admin) ұйымдағы барлық адамдар-мен қосымшаларды бөлісе алады.

Бұл қатысушы параметрлерінің мәніне қарамастан, бөлісу артықшылығы бар жасаушылар қолданбаларды кез келген өлшемдегі қауіпсіздік топтарымен бөлісе алады. Бұл басқару тек Барлық қысқашаны ортақ пайдалану кезінде пайдалануға болатынын анықтайды.

Қолданбаларды Барлығымен бөлісу мүмкіндігі үшін жалға алушы параметрін өзгертіңіз

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

Surface арқылы ұйымыңыздың басқару қатесі туралы хабарлама мазмұнын көрсетіңіз

Қате хабарларында көрсетілетін басқару қате туралы хабардың мазмұнын көрсетсеңіз, жасаушылар қолданбаларды Барлығымен бөлісуге рұқсаты жоқ екенін байқаған кезде қате хабарындағы мазмұн көрсетіледі. PowerShell басқару қатесі туралы хабар мазмұнының пәрмендері бөлімін қараңыз.

Бағдарламаға мәтінмәндік ағындармен байланыстыру

Бағдарлама мен ағындар арасында тәуелділікті жасау үшін бағдарламаның мәтінмәніндегі ағындарды бағдарламаға байланыстырыңыз. Контексттік ағындар туралы толығырақ білу үшін Power Apps лицензияларына қандай Power Automate мүмкіндіктер кіреді?

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

EnvironmentName және FlowName өрістерін ағынның url мекенжайынан табылуы мүмкін:

• Шешімсіз ағын үшін URL келесідей көрінеді:

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

  environments/ кейінгі GUID орта аты, ал flows/ ден кейінгі GUID - ағын атауы

• Шешім ағыны үшін URL келесідей көрінеді:

  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
  

  environments/ кейінгі GUID орта аты, ал flows/ ден кейінгі GUID - ағын атауы

• Кенеп қолданбасына арналған AppName мәнін кенеп қолданбасының мәліметтері бетінен табуға болады.

  

• Модельге негізделген қолданбаға арналған AppName параметрін шешім шолғышында табуға болады.

  

• Мысалдар көру үшін теріңіз: get-help Add-AdminFlowPowerAppContext -examples.

• Қосымша ақпарат алу үшін теріңіз: get-help Add-AdminFlowPowerAppContext -detailed.

• Техникалық ақпаратты алу үшін: get-help Add-AdminFlowPowerAppContext -full теріңіз.

Бағдарламаның мәнмәтіндік ағындарынан жою

Осы PowerShell пәрменінің көмегімен ағындар мен бағдарлама арасындағы тәуелділікті жойыңыз. Remove-AdminFlowPowerAppContext арнайы ағыннан бағдарлама мәтінмәнін жояды.

    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 командалары

Осы маңызды командаларды Power Automate-қа қатысты әкімшілікті орындау үшін қолданыңыз.

Әкімшілерге арналған Power Automate және Power Apps cmdlet-тердің толық тізімі үшін PowerShell for Power Platform Administrators бөлімінен қараңыз.

Барлық ағындарды көрсету

Get-AdminFlow

Қатысушыдағы барлық ағындардың тізімін қайтарады.

Ағын иесінің рөлі туралы мәліметтерді көрсету

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

Көрсетілген ағынның иесі туралы мәліметтерді қайтарады.

Ескертпе

Орталар және PowerApps сияқты, FlowName бірегей идентификатор (нұсқаулық), ол ағынның көрсетілетін атауынан басқаша.

Ағын пайдаланушысының мәліметтерін көрсету

Get-AdminFlowUserDetails –UserId $Global:currentSession.userId

Ағынды пайдалануға қатысты пайдаланушы мәліметтерін қайтарады. Бұл мысалда біз енгізу ретінде PowerShell сеансының ағымдағы кірген пайдаланушысының пайдаланушы идентификаторын пайдаланып жатырмыз.

Ағын пайдаланушысының мәліметтерін жою

Remove-AdminFlowUserDetails –UserId 'UserId'

Microsoft дерекқорынан ағын пайдаланушысы туралы мәліметтерді толығымен жояды. Ағын пайдаланушысының мәліметтерін жою үшін кіріс пайдаланушысының иелігіндегі барлық ағындар жойылуы керек.

Ескертпе

UserId өрісі — пайдаланушының Microsoft Entra жазбасының Object ID, ол Azure порталындаMicrosoft Entra ID>Users>Profile>Object ID астында орналасқан. Осы деректерге осы жерден қатынасу үшін сіз әкімші болуыңыз керек.

Барлық ағындарды CSV файлына экспорттау

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

Қатысушыдағы барлық ағындарды кестелік көрініс .csv файлына экспорттайды.

Ағындарды Dataverse шешімдерге қосыңыз

Add-AdminFlowsToSolution -EnvironmentName <String>

Қоршаған ортадағы барлық ерітінді емес ағындарды тасымалдайды.

Параметрлердің вариациялары тек нақты ағындарды тасымалдау, нақты шешімге қосу немесе бір уақытта ағындардың тек белгіленген санын тасымалдау үшін пайдаланылуы мүмкін.

Техникалық мәліметтерді Add-AdminFlowsToSolution бөлімінен қараңыз.

HTTP әрекет ағындарын тізімдеу

Get-AdminFlowWithHttpAction -EnvironmentName <String>

HTTP әрекеттері бар ағындарды тізімдейді.

Дисплей атауы	АғыншыАтауы	EnvironmentName
Шот-фактураны HTTP алу	Ағын-1	Қоршаған орта-1
Бағдарламадан шот-фактураны төлеу	Ағын-2	Қоршаған орта-2
Тіркелгіні келістіру	Ағын-3	Қоршаған орта-3

API қосылым командалары

Қатысушыдағы API қосылымдарын қараңыз және басқарыңыз.

Әдепкі ортадағы барлық бастапқы қосылымдарды көрсету

Get-AdminPowerAppEnvironment -Default | Get-AdminPowerAppConnection

Әдепкі ортадағы барлық API қосылымдарының тізімін көрсетеді. Жергілікті қосылымдар Dataverse>Connections қойындысында Power Apps бөлімінде орналасқан.

Қатысушыдағы барлық реттелетін қосқыштарды көрсету

Get-AdminPowerAppConnector

Қатысушыдағы барлық реттелетін қосқыш мәліметтерінің тізімін қайтарады.

Ескертпе

Get-AdminPowerAppConnector шешімдегі реттелетін қосқыштарды тізімдемейді. Бұл белгілі шектеу болып табылады.

Деректер саясаты пәрмендері

Бұл командлеттер клиенттегі деректер саясатын басқарады.

Деректер саясатын жасау

New-DlpPolicy

Кірген әкімшінің клиенті үшін жаңа деректер саясатын жасайды.

Деректер саясаты нысандарының тізімін алу

Get-DlpPolicy

Жүйеге кірген әкімші қатысушысы үшін жаңа саясат нысандарын алады.

Ескертпе

• PowerShell бағдарламасын пайдаланып деректер саясатын көргенде, коннекторлардың көрсетілетін атауы деректер саясаты жасалған сәттен немесе коннекторлар саясат ішінде соңғы рет жылжытылған кезден алынады. Қосқыштардың көрсетілетін атауларындағы жаңа өзгерістер көрсетілмейді.
• PowerShell бағдарламасын пайдаланып деректер саясатын көргенде, әдепкі топтағы жылжытылмаған жаңа қосқыштар қайтарылмайды.

Осы белгілі мәселелердің екеуі үшін де уақытша шешім зардап шеккен қосқышты саясат ішіндегі басқа топқа жылжыту, содан кейін оны дұрыс топқа қайта жылжыту болып табылады. Осы мақсатқа жету үшін әр топтың аты-жөні анықталады.

Деректер саясатын жаңарту

Set-DlpPolicy

Саясаттың көрсетілетін атауы сияқты саясат мәліметтерін жаңартады.

Саясатты жою

Remove-DlpPolicy

Деректер саясатын жояды.

Деректер ресурстарынан босату cmdlets

Бұл командлеттер белгілі бір ресурсты саясаттан босатуға немесе босатуға мүмкіндік береді.

Деректер саясаты үшін бұрыннан босатылған ресурстар тізімін алу

Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Деректер саясаты үшін жаңа босатылған ресурстар тізімін жасау

New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources 

Деректер саясаты үшін босатылған ресурстар тізімін жаңарту

Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources 

Деректер саясаты үшін босатылған ресурстар тізімін жою

Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName 

Ресурсты деректер саясатынан босату үшін келесі ақпарат қажет:

• Клиент идентификаторы (GUID)
• Деректер саясатының идентификаторы (GUID)
• Ресурс идентификаторы (GUID-мен аяқталады)
• Ресурс түрі

Ресурс идентификаторын және түрін Power-Shell командлеттері арқылы шығарып алуға болады: бағдарламалар үшін Get-PowerApp және ағындар үшін Get-Flow.

Жою сценарийінің мысалы

ID f239652e-dd38-4826-a1de-90a2aea584d9 және ID 06002625-7154-4417-996e-21d7a60ad624 қолданбасы бар ағынды босату үшін келесі командлеттерді іске қоса аламыз:

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

Келесі сценарийлерде деректер саясатынан босату тәжірибесі

#	Сценарий	Тәжірибе
1-көше	Пайдаланушы деректер саясатына сәйкес емес, бірақ деректер саясатынан босатылған бағдарламаны іске қосады.	Бағдарламаны іске қосу деректер саясатының орындалуымен немесе онсыз жалғасады.
2-көше	Maker деректер саясатына сәйкес келмеген, бірақ деректер саясатынан босатылған бағдарламаны сақтайды	Деректер саясатынан босатылған немесе онсыз деректер саясатының сәйкестігі бағдарламаны сақтау операциясына кедергі келтірмейді. Деректер саясатының сәйкессіздігі туралы ескерту деректер саясатынан босатылғанына қарамастан көрсетіледі.
3-көше	Maker деректер саясатына сәйкес емес, бірақ деректер саясатынан босатылған ағынды сақтайды	Деректер саясатынан босатылса немесе онсыз деректер саясатының сәйкестігі ағынды сақтау операциясына кедергі келтірмейді. Деректер саясатының сәйкессіздігі туралы ескерту көрсетілмейді.

Басқару қатесі туралы хабар мазмұнының пәрмендері

Келесі командлеттер соңғы пайдаланушыларды ұйымыңыздың басқару анықтамалық материалына апаруы мүмкін. Пәрмен басқару құжаттамасына сілтемені және басқаруды басқару элементтері сұраған кездегі басқару контактісін қамтиды. Мысалы, басқару қатесі хабарламасының мазмұны орнатылғанда, ол Power Apps деректер саясатының орындау уақытындағы орындау хабарламаларында көрінеді.

Басқару қатесі туралы хабар мазмұнын орнату

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

Басқару қатесі туралы хабардың URL мекенжайын және электрондық поштасын тәуелсіз немесе бірге көрсетуге болады. Басқару қатесі туралы хабарды enabled өрісі арқылы қосуға немесе өшіруге болады.

Басқару қатесі туралы хабардың мазмұн сценарийлері

#	Сценарий	Қолжетімділік
1-көше	Пайдаланушы Power Apps арқылы жасалған, деректер саясатына сай емес қосымшаны іске қосады	Жалпы қолжетімді
2-көше	Maker Power Apps canvas қосымшасын бөліседі, бірақ бөлісу құқығы жоқ	Жалпы қолжетімді
3-көше	Maker Power Apps Canvas қосымшасын Everyone арқылы бөліседі, бірақ Everyone	Жалпы қолжетімді
4	Maker Power Apps арқылы жасалған, бірақ деректер саясатына сай емес қосымшаны сақтайды	Жалпы қолжетімді
5	Maker деректер саясатына сәйкес келмейтін Power Automate ағынын сақтайды	Жалпы қолжетімді
6	Пайдаланушы Dataverse ортамен байланысты қауіпсіздік тобына қауіпсіздік тобы мүшелігі жоқ қолданбаны іске қосады	Жалпы қолжетімді

Басқару қатесі туралы хабар мазмұнын көрсету

Get-PowerAppDlpErrorSettings -TenantId 'TenantId' 

Басқару қатесі туралы хабар мазмұнын жаңарту

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

Байланыстарды бұзу үшін деректер саясатын орындау - Қоршаған орта

Бұл командлеттер орта немесе клиент деңгейіндегі қосылымдарды бұзу үшін деректер саясатын орындауға мүмкіндік береді.

Қосылымдарды бұзу үшін деректер саясатын орындау

Сіз ортадағы байланыстар туралы деректер саясатын орындай аласыз. Мәжбүрлеу деректер саясатын бұзатын қолданыстағы қосылымдарды өшіреді және деректер саясатын бұзбайтын бұрын ажыратылған қосылымдарды қосады.

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName [Environment ID]

Ортаны орындау сценарийінің мысалы

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

Қосылымдарды бұзу үшін деректер саясатын орындау - клиент

Жалға алушыдағы қосылымдардағы деректер саясатын орындауға болады. Мәжбүрлеу деректер саясатын бұзатын қолданыстағы қосылымдарды өшіреді және деректер саясатын бұзбайтын бұрын ажыратылған қосылымдарды қосады.

Start-DLPEnforcementOnConnectionsInTenant

Сынақ лицензияларының пәрмендерін блоктау

Пәрмендер:

Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans

Рұқсат етілген келісім жоспарларының командлеттерін қатысушыдан келісім жоспарының белгілі бір түріне қатынасты қосу немесе жою үшін пайдалануға болады. "Ішкі" келісім жоспарлары — бұл пайдаланушылар Power Apps/Power Automate порталдары/Power Automate арқылы тіркеле алатын сынақ лицензиялары немесе әзірлеуші жоспарлары. «Ад-hoc жазылым» немесе «Вирусты» келісім жоспарлары — пайдаланушылар https://signup.microsoft.com сайтында тіркеле алатын сынақ лицензиялары. Әкімшілер пайдаланушыларды Microsoft Entra ID немесе Microsoft 365 әкімшілік порталы арқылы тағайындай алады.

Әдепкі бойынша, келісім жоспарларының барлық түрлеріне жалға алушыға рұқсат етіледі. Алайда, Power Platform әкімшісі пайдаланушылардың өздеріне сынақ лицензияларын тағайындауына тыйым салғысы келуі мүмкін, бірақ пайдаланушылардың атынан сынақ лицензияларын тағайындау мүмкіндігін сақтап қалуы мүмкін. Бұл ережені Remove-AllowedConsentPlans -Types "Internal" командасын қолдану және Microsoft Entra ID Update-MgPolicyAuthorizationPolicy -AllowedToSignUpEmailBasedSubscriptions параметрін бермеу арқылы жүзеге асыруға болады.

Сұрақтарыңыз болса

Егер пікірлеріңіз, ұсыныстарыңыз немесе сұрақтарыңыз болса, оларды Adadmining Power Apps қауымдастық тақтасына жариялаңыз.

Қатысты ақпарат

• Power Apps admin модулін қолдана бастаңыз.
  
• Microsoft.PowerApps.Әкімшілік.PowerShell
  
• алдын ала қарау нұсқасы: Бағдарламалану және кеңейту мүмкіндігіне шолу