Get-AdaptiveScopeMembers

Get-AdaptiveScopeMembers
    [-Identity] <ComplianceRuleIdParameter>
    [<CommonParameters>]

Get-AdaptiveScopeMembers
    [-Identity] <ComplianceRuleIdParameter>
    [-AdaptiveReportFilters <PswsHashtable>]
    [-EndDateTime <DateTimeOffset>]
    [-PageResultSize <UnlimitedInt>]
    [-StartDateTime <DateTimeOffset>]
    [-State <LocationState>]
    [<CommonParameters>]

Get-AdaptiveScopeMembers
    [-Identity] <ComplianceRuleIdParameter>
    -AdaptiveReportQuery <String>
    [<CommonParameters>]

Get-AdaptiveScopeMembers
    [-Identity] <ComplianceRuleIdParameter>
    -PageCookie <string>
    [<CommonParameters>]

Используйте этот командлет для получения существующих и прошлых участников (пользователей, групп или сайтов) адаптивной области.

Выходные данные командлета представляют собой список, первый элемент которого содержит метаданные результата. Последующие элементы содержат элементы.

Метаданные включают следующие сведения:

• Общее число участников запроса.
• Количество участников, возвращаемое на текущей странице.
• Наличие дополнительных страниц.

Если существуют дополнительные страницы, метаданные включают значение Watermark и значение IsLastPage False.

Чтобы получить следующую страницу, передайте значение Watermark в параметр PageCookie при следующем вызове командлета. Используйте параметр AdaptiveReportFilters для фильтрации элементов.

Чтобы использовать этот командлет в PowerShell безопасности и соответствия требованиям, вам должны быть назначены соответствующие разрешения. Дополнительные сведения см. в статье Разрешения на портале соответствия требованиям Microsoft Purview.

Get-AdaptiveScopeMembers -Identity "US Finance Users"

В этом примере извлекаются члены адаптивной области "Финансовые пользователи США". Если область содержит менее 10 000 элементов, возвращаются все члены.

Для больших областей включаются только первые 10 000 членов, а первый объект в отклике содержит метаданные с водяным знаком, который можно использовать для запроса последующих страниц.

Get-AdaptiveScopeMembers -Identity "US Finance Users" -PageResultSize Unlimited

В этом примере возвращаются все члены адаптивной области "Финансовые пользователи США".

Важно! Не рекомендуется использовать значение PageResultSize "Без ограничений" для больших адаптивных областей. Использование "Без ограничений" для больших адаптивных областей может привести к длительным запросам и временным сбоям, которые невозможно эффективно предотвратить.

Get-AdaptiveScopeMembers -Identity "US Finance Users" -PageResultSize 0

В этом примере возвращаются только метаданные с общим количеством участников адаптивной области "Финансовые пользователи США".

Get-AdaptiveScopeMembers -Identity "US Finance Users" -PageResultSize 30

В этом примере извлекаются члены адаптивной области "Финансовые пользователи США". Если область содержит менее 30 элементов, возвращаются все члены.

Для больших областей включаются только первые 30 членов, а первый объект в отклике содержит метаданные с водяным знаком, который можно использовать для запроса последующих страниц.

Get-AdaptiveScopeMembers -Identity "US Finance Users" -State Added

В этом примере извлекаются текущие члены адаптивной области "Пользователи финансов США". Если область содержит менее 10 000 текущих элементов, возвращаются все текущие члены.

Для больших областей включаются только первые 10 000 текущих членов, а первый объект в отклике содержит метаданные с водяным знаком, который можно использовать для запроса последующих страниц.

Get-AdaptiveScopeMembers -Identity "US Finance Users" -State Removed

В этом примере извлекаются прошлые члены адаптивной области "Финансовые пользователи США". Если в область меньше 10 000 бывших участников, возвращаются все бывшие участники.

Для более крупных областей включаются только первые 10 000 бывших участников, а первый объект в отклике содержит метаданные с водяным знаком, который можно использовать для запроса последующих страниц.

Get-AdaptiveScopeMembers -Identity "US Finance Sites" -AdaptivereportFilters @{"SiteUrlContainsAny" = @("/personal/", "/teams/")}

В этом примере извлекаются члены адаптивной области "Финансовые сайты США", в которых URL-адрес сайта содержит /personal/ или /teams/. Если результаты содержат менее 10 000 элементов, возвращаются все.

Для получения более крупных результатов включаются только первые 10 000, а первый объект в отклике содержит метаданные с водяным знаком, который можно использовать для запроса последующих страниц.

$scope="US Finance Users"; $size=200; $cookie=$null
$all=@()
do {
  $page = Get-AdaptiveScopeMembers -Identity $scope -Size $size -PageCookie $cookie
  if(-not $page){ break }
  $meta = $page[0]
  if($meta.CurrentPageMemberCount -gt 0){ $all += $page[1..($page.Count-1)] }
  $cookie = if($meta.IsLastPage){ $null } else { $meta.Watermark }
} while($cookie -ne $null)
$all | Export-Csv -NoTypeInformation -Path "C:\Data\AdaptiveScopeMembers_$($scope -replace ' ','_').csv"

В этом примере извлекаются члены адаптивной области "Финансовые пользователи США 200 участников одновременно" и сохраняются в списке. Результаты сохраняются в указанном CSV-файле.

function Export-AdaptiveScopeMembers {
    [CmdletBinding()] param([string]$Scope,[string]$Out,[int]$Size=10000,[bool]$Resume=$true)
  $scope=$Scope; $out=$Out; $size=$Size;
  $meta=Join-Path $out "$scope-exportadaptivescopemembersexecutioninfo.json"
  if (-not (Test-Path $out)) { New-Item -ItemType Directory -Path $out | Out-Null }
  $m = if ($resume -and (Test-Path $meta)) { Get-Content $meta -Raw | ConvertFrom-Json } else {$null}
  $cookie = if ($m) {$m.Watermark} else {$null}; $page = if ($m -and $m.IsLastPage -ne $true) { $m.LastPageProcessed + 1 } else {1}; $isLast=$false
  do {
    $res = if ($cookie) { Get-AdaptiveScopeMembers -Identity $scope -PageCookie $cookie -WarningAction SilentlyContinue} else { Get-AdaptiveScopeMembers -Identity $scope -PageResultSize $size -WarningAction SilentlyContinue }
    $metaObj = $res[0]; $members = $res[1..($res.Count-1)]
    if ($members.Count) { $file=Join-Path $out "$scope-part$($page).csv"; $members | Export-Csv $file -NoTypeInformation; Write-Host "Exported $($members.Count) of page $page to file '$file'" }
    $cookie = $metaObj.Watermark; $isLast = $metaObj.IsLastPage
    $status = @{TimestampUtc=(Get-Date).ToUniversalTime().ToString("o"); TotalResults=$metaObj.TotalMemberCount; PageSize=$metaObj.CurrentPageMemberCount; Identity=$metaObj.Identity; Watermark=$cookie; LastPageProcessed=$page; IsLastPage=$metaObj.IsLastPage}
    if ($isLast)   {
      $status = @{TimestampUtc=(Get-Date).ToUniversalTime().ToString("o"); TotalResults=$metaObj.TotalMemberCount; Identity=$metaObj.Identity; Watermark=$cookie; LastPageProcessed=$page; IsLastPage=$metaObj.IsLastPage}
    }
    $status | ConvertTo-Json | Set-Content $meta
    $page++
  } while (-not $isLast)
  Write-Host "Completed exporting members of adaptive scope '$scope' to folder '$out'"
}

Клиентам часто требуется экспортировать всех участников адаптивной области в файлы для просмотра, аудита, автономного анализа или совместного использования с другими командами. Этот вспомогательный сценарий Export-AdaptiveScopeMembers упрощает этот процесс, автоматически просматривая области данных, экспортируя каждую страницу в CSV-файл и записывая метаданные выполнения для резюме.

Этот рабочий процесс экспорта можно перезапустить. Если сценарий остановится на полпути из-за временного сбоя, проблемы с сетью или тайм-аута, вы можете просто запустить его снова. Он считывает существующий файл метаданных, возобновляет работу с последней успешно обработанной страницы и продолжает экспорт до тех пор, пока не будут извлечены все страницы.

Вставьте эту функцию в свою сессию и вызовите ее с нужными параметрами. Можно позвонить Export-AdaptiveScopeMembers , чтобы сохранить результаты в файлы.

В этом примере извлекаются члены адаптивной области "Финансовые пользователи США" и сохраняются каждые 10 000 участников в CSV-файле в указанной папке. Если папка еще не создана:

Export-AdaptiveScopeMembers -Scope "US Finance Users" -Out "D:\adaptivescopedetails".

В этом примере извлекаются члены адаптивной области "Финансовые пользователи США" и сохраняются каждые 200 участников в CSV-файле в указанной папке. Если папка еще не создана:

Export-AdaptiveScopeMembers -Scope "US Finance Users" -Out "D:\adaptivescopedetails" -Size 200.

По умолчанию параметру -Resume присвоено значение $true, что позволяет автоматически продолжить процесс экспорта с последней завершенной страницы, если сеанс PowerShell прерван. Укажите $false, чтобы начать экспорт с самого начала и перезаписать ранее сохраненный ход выполнения.

Export-AdaptiveScopeMembers -Scope "US Finance Users" -Out "D:\adaptivescopedetails" -Size 200 -Resume $false

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.