Get-AdaptiveScopeMembers

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

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

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

Utilize este cmdlet para obter membros existentes e anteriores (utilizadores, grupos ou sites) de um âmbito adaptável.

O resultado do cmdlet é uma lista onde o primeiro elemento contém metadados de resultados. Os elementos subsequentes contêm os membros.

Os metadados incluem as seguintes informações:

• O número total de membros do pedido.
• O número de membros devolvidos na página atual.
• Se estão disponíveis páginas adicionais.

Se existirem páginas adicionais, os metadados incluem um valor de Marca d'água e o valor IsLastPage é Falso.

Para obter a página seguinte, transmita o valor De marca d'água para o parâmetro PageCookie na próxima invocação do cmdlet. Utilize o parâmetro AdaptiveReportFilters para filtrar os membros.

Para usar este cmdlet no PowerShell de Segurança e Conformidade, você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.

Get-AdaptiveScopeMembers -Identity "US Finance Users"

Este exemplo obtém os membros do âmbito ajustável Us Finance Users. Se o âmbito contiver menos de 10 000 membros, todos os membros serão devolvidos.

Para âmbitos maiores, apenas os primeiros 10 000 membros são incluídos e o primeiro objeto na resposta contém metadados com uma marca d'água que pode ser utilizada para pedir páginas subsequentes.

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

Este exemplo devolve todos os membros do âmbito adaptável Us Finance Users.

Importante: não recomendamos a utilização do valor PageResultSize Ilimitado para grandes âmbitos ajustáveis. A utilização de Ilimitados em âmbitos adaptativos grandes pode levar a pedidos de execução prolongada e falhas transitórias que não podem ser repetidas de forma eficiente.

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

Este exemplo só devolve metadados com a contagem total de membros do âmbito adaptável Us Finance Users.

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

Este exemplo obtém os membros do âmbito ajustável Us Finance Users. Se o âmbito contiver menos de 30 membros, todos os membros serão devolvidos.

Para âmbitos maiores, apenas os primeiros 30 membros são incluídos e o primeiro objeto na resposta contém metadados com uma marca d'água que pode ser utilizada para pedir páginas subsequentes.

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

Este exemplo obtém os membros atuais do âmbito adaptável Us Finance Users. Se o âmbito contiver menos de 10 000 membros atuais, todos os membros atuais serão devolvidos.

Para âmbitos maiores, apenas os primeiros 10 000 membros atuais estão incluídos e o primeiro objeto na resposta contém metadados com uma marca d'água que pode ser utilizada para pedir páginas subsequentes.

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

Este exemplo obtém os membros anteriores do âmbito adaptável Us Finance Users. Se o âmbito contiver menos de 10 000 membros anteriores, todos os membros anteriores serão devolvidos.

Para âmbitos maiores, apenas os primeiros 10 000 membros anteriores estão incluídos e o primeiro objeto na resposta contém metadados com uma marca d'água que pode ser utilizada para pedir páginas subsequentes.

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

Este exemplo obtém os membros dos Sites Financeiros dos E.U.A. de âmbito adaptável onde o URL do site contém /personal/ ou /teams/. Se os resultados contiverem menos de 10 000 membros, todos serão devolvidos.

Para resultados maiores, apenas os primeiros 10 000 estão incluídos e o primeiro objeto na resposta contém metadados com uma marca d'água que pode ser utilizada para pedir páginas subsequentes.

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

Este exemplo obtém os membros do âmbito adaptável Us Finance Users 200 membros de cada vez e guarda-os numa lista. Os resultados são guardados no ficheiro CSV especificado.

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

Muitas vezes, os clientes precisam de exportar todos os membros de um âmbito adaptável para ficheiros para revisão, auditoria, análise offline ou para partilhar com outras equipas. Este script auxiliar Export-AdaptiveScopeMembers simplifica este processo ao paginar automaticamente o âmbito, exportar cada página para um ficheiro CSV e escrever metadados de execução para retomar.

Este fluxo de trabalho de exportação é reiniciável. Se o script parar a meio devido a uma falha transitória, problema de rede ou tempo limite, pode simplesmente executá-lo novamente. Lê o ficheiro de metadados existente, retoma a partir da última página processada com êxito e continua a exportar até que todas as páginas tenham sido obtidas.

Cole esta função na sua sessão e chame-a com os parâmetros pretendidos. Pode ligar Export-AdaptiveScopeMembers para guardar os resultados em ficheiros.

Este exemplo obtém os membros do âmbito ajustável Us Finance Users e guarda cada 10 000 membros num ficheiro csv na pasta fornecida. A pasta é criada se ainda não existir:

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

Este exemplo obtém os membros do âmbito adaptável Us Finance Users e guarda cada 200 membros num ficheiro csv na pasta fornecida. A pasta é criada se ainda não existir:

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

Por predefinição, o parâmetro -Resume está definido como $true, permitindo que o processo de exportação continue automaticamente a partir da última página concluída se uma sessão do PowerShell for interrompida. Especifique $false para iniciar a exportação desde o início e substituir qualquer progresso guardado anteriormente.

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

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.