Compartilhar via

Start-SPODataAccessGovernanceInsight

Módulo:
Microsoft.Online.SharePoint.PowerShell Module

Este cmdlet gera relatórios da Governação de Acesso a Dados (DAG) destinados a fornecer informações sobre potenciais partilhas de dados confidenciais no SharePoint e/ou OneDrive for Business. Gerenciamento Avançado do SharePoint licença (SAM) é necessária para executar estes relatórios.

Sintaxe

EEEUParameterSet 

Start-SPODataAccessGovernanceInsight
    -ReportEntity <ReportEntityEnum>
    -Workload <WorkloadEnum>
    -ReportType <ReportTypeEnum>
    -Name <String>
    [-Template <System.Collections.Generic.List`1[Microsoft.Online.SharePoint.TenantAdministration.TemplateEnum]>]
    [-Privacy <PrivacyEnum>]
    [-SiteSensitivityLabelGUID <System.Collections.Generic.List`1[System.Guid]>]
    [<CommonParameters>]

SharingLinkParameterSet 

Start-SPODataAccessGovernanceInsight
    -ReportEntity <ReportEntityEnum>
    -Workload <WorkloadEnum>
    -ReportType <ReportTypeEnum>
    [<CommonParameters>]

LabelParameterSet 

Start-SPODataAccessGovernanceInsight
    -ReportEntity <ReportEntityEnum>
    -Workload <WorkloadEnum>
    -ReportType <ReportTypeEnum>
    -FileSensitivityLabelGUID <Guid>
    [-FileSensitivityLabelName <String>]
    [<CommonParameters>]

SitePermissionsParameterSet 

Start-SPODataAccessGovernanceInsight
    -ReportEntity <ReportEntityEnum>
    -Workload <WorkloadEnum>
    -ReportType <ReportTypeEnum>
    -Name <String>
    -CountOfUsersMoreThan <Int32>
    [-Template <System.Collections.Generic.List`1[Microsoft.Online.SharePoint.TenantAdministration.TemplateEnum]>]
    [-Privacy <PrivacyEnum>]
    [-SiteSensitivityLabelGUID <System.Collections.Generic.List`1[System.Guid]>]
    [<CommonParameters>]

UserPermissionsParameterSet 

Start-SPODataAccessGovernanceInsight
    -ReportEntity <ReportEntityEnum>
    -Workload <WorkloadEnum>
    -ReportType <ReportTypeEnum>
    -Name <String>
    -UserEmailList <System.Collections.Generic.List`1[System.String]>
    [<CommonParameters>]

Description

Este cmdlet é utilizado para gerar relatórios DAG que lidam com potenciais partilhas excessivas de dados confidenciais. Estes relatórios estão presentes no centro de administração do Sharepoint. Os relatórios estão atualmente disponíveis para os seguintes cenários:

  • Ligações de partilha criadas nos últimos 28 dias (Qualquer pessoa, Pessoas na sua organização, Pessoas específicas partilhadas externamente).
  • Conteúdo partilhado com Todos, exceto utilizadores externos (EEEU) nos últimos 28 dias.
  • Lista de sites com ficheiros etiquetados, a partir do tempo de geração de relatórios.
  • Lista de sites com "demasiados utilizadores", a partir do tempo de geração de relatórios, para configurar uma linha de base de partilha excessiva.
  • Lista de sites com permissões diretas ou indiretas para determinados utilizadores. (Pré-visualização Privada)

Exemplos

Exemplo 1

Start-SPODataAccessGovernanceInsight -ReportEntity PermissionedUsers -Workload SharePoint -ReportType Snapshot -Name "OversharingBaselineReport" -CountOfUsersMoreThan 0

O cmdlet acima gera uma lista de sites do SharePoint que podem ser acedidos por mais de 1000 utilizadores a partir do dia da geração de relatórios.

Parâmetros

-CountOfUsersMoreThan

Especifica o limiar de partilha excedida, conforme definido pelo número de utilizadores que podem aceder ao site. O número de utilizadores que podem aceder ao site é determinado ao expandir todos os utilizadores, grupos em todas as permissões (ao nível do site e ao nível de qualquer item com permissões não obrigatórias), anular a eliminação de duplicados e chegar a um número exclusivo. O valor mínimo é 0.

Propriedades do parâmetro

Tipo:System.Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SitePermissionsParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FileSensitivityLabelGUID

Especifica o GUID para a etiqueta de confidencialidade do ficheiro.

Propriedades do parâmetro

Tipo:System.Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

LabelParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FileSensitivityLabelName

Especifica o nome da etiqueta de confidencialidade para o ficheiro.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

LabelParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome a atribuir ao relatório gerado.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

EEEUParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SitePermissionsParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
UserPermissionsParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Privacy

Especifica a definição de privacidade do grupo do Microsoft 365. Relevante no caso de filtrar o relatório para sites ligados a grupos.

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.TenantAdministration.PrivacyEnum
Valor padrão:None
Valores aceitos:All, Private, Public
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

EEEUParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SitePermissionsParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ReportEntity

Especifica a entidade que pode causar a partilha excedida e, por conseguinte, controlada por estes relatórios.

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.TenantAdministration.ReportEntityEnum
Valor padrão:None
Valores aceitos:SharingLinks_Anyone, SharingLinks_PeopleInYourOrg, SharingLinks_Guests, SensitivityLabelForFiles, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, PermissionedUsers, PermissionsReport
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ReportType

Especifica o período de tempo dos dados com base no qual o relatório DAG é gerado. Um relatório "Instantâneo" terá os dados mais recentes a partir do tempo de geração do relatório. Um relatório "RecentActivity" será baseado em dados nos últimos 28 dias.

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.TenantAdministration.ReportTypeEnum
Valor padrão:None
Valores aceitos:Snapshot, RecentActivity
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SiteSensitivityLabelGUID

Especifica o GUID da etiqueta de confidencialidade aplicada ao site.

Propriedades do parâmetro

Tipo:

System.Collections.Generic.List`1[System.Guid]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

EEEUParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SitePermissionsParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Template

Especifica o modelo do site. Relevante no caso de ser gerado um relatório para esse modelo específico.

Propriedades do parâmetro

Tipo:

System.Collections.Generic.List`1[Microsoft.Online.SharePoint.TenantAdministration.TemplateEnum]

Valor padrão:None
Valores aceitos:AllSites, ClassicSites, CommunicationSites, TeamSites, OtherSites
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

EEEUParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
SitePermissionsParameterSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UserEmailList

Especifica os IDs de e-mail dos utilizadores para os quais o relatório de permissões deve ser gerado.

Propriedades do parâmetro

Tipo:

System.Collections.Generic.List`1[System.String]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UserPermissionsParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Workload

Especifica se o relatório se destina a sites do SharePoint ou contas do OneDrive.

Propriedades do parâmetro

Tipo:Microsoft.Online.SharePoint.TenantAdministration.WorkloadEnum
Valor padrão:None
Valores aceitos:SharePoint, OneDriveForBusiness
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

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.

Entradas

None

Saídas

System.Object