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

このコマンドレットを使用して、適応型スコープの既存および過去のメンバー (ユーザー、グループ、またはサイト) を取得します。

コマンドレットの出力は、最初の要素に結果メタデータが含まれるリストです。 後続の要素にはメンバーが含まれます。

メタデータには次の情報が含まれます。

• 要求のメンバーの合計数。
• 現在のページに返されるメンバーの数。
• 追加のページが使用できるかどうか。

追加のページが存在する場合、メタデータには透かし値が含まれ、IsLastPage 値は False になります。

次のページを取得するには、次にコマンドレットを呼び出すときに、PageCookie パラメーターに透かし値を渡します。 AdaptiveReportFilters パラメーターを使用してメンバーをフィルター処理します。

セキュリティ/コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可が割り当てられている必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。

Get-AdaptiveScopeMembers -Identity "US Finance Users"

この例では、アダプティブ スコープ US Finance Users のメンバーを取得します。 スコープに含まれるメンバーが 10,000 より少ない場合は、すべてのメンバーが返されます。

スコープが大きい場合、最初の 10,000 人のメンバーのみが含まれ、応答の最初のオブジェクトには、後続のページの要求に使用できる透かしを含むメタデータが含まれます。

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

この例では、アダプティブ スコープ US Finance Users のすべてのメンバーを返します。

重要: 大規模な適応型スコープでは、PageResultSize 値 Unlimited を使用することはお勧めしません。 大規模な適応型スコープで [無制限] を使用すると、要求の実行時間が長くなり、効率的に再試行できない一時的なエラーが発生する可能性があります。

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

この例では、アダプティブ スコープの US Finance Users のメンバーの合計数を含むメタデータのみを返します。

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

この例では、アダプティブ スコープ US Finance Users のメンバーを取得します。 スコープに含まれるメンバーが 30 未満の場合は、すべてのメンバーが返されます。

スコープが大きい場合、最初の 30 個のメンバーのみが含まれ、応答の最初のオブジェクトには、後続のページの要求に使用できる透かしを含むメタデータが含まれます。

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

この例では、アダプティブ スコープ US Finance Users の現在のメンバーを取得します。 スコープに含まれる現在のメンバーが 10,000 より少ない場合は、現在のメンバーすべてが返されます。

スコープが大きい場合、現在のメンバーの最初の 10,000 個のみが含まれ、応答の最初のオブジェクトには、後続のページの要求に使用できる透かしを含むメタデータが含まれます。

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

この例では、アダプティブ スコープ US Finance Users の過去のメンバーを取得します。 スコープに過去のメンバーが含まれているものが 10,000 人未満の場合は、過去のメンバーがすべて返されます。

スコープが大きい場合、最初の 10,000 人の過去のメンバーのみが含まれ、応答の最初のオブジェクトには、後続のページの要求に使用できる透かしを含むメタデータが含まれます。

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

この例では、アダプティブ スコープ US Finance Sites (サイト 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"

この例では、アダプティブ スコープ US Finance Users 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 を呼び出して、結果をファイルに保存できます。

この例では、アダプティブ スコープ US Finance Users のメンバーを取得し、メンバーの 10,000 人ごとに、提供されたフォルダーの下の csv ファイルに保存します。 フォルダーがまだ存在しない場合は作成されます。

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

この例では、アダプティブ スコープ US Finance Users のメンバーを取得し、メンバー 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」を参照してください。