Condividi tramite

Start-SPODataAccessGovernanceInsight

Modulo:
Microsoft.Online.SharePoint.PowerShell Module

Questo cmdlet genera report di governance dell'accesso ai dati (DAG) destinati a fornire informazioni dettagliate sulla potenziale sovrascivolta dei dati sensibili in SharePoint e/o OneDrive for Business. Per eseguire questi report è necessaria la licenza DIA (SharePoint Advanced Management).

Sintassi

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>
    -UserPrincipalNames <System.Collections.Generic.List`1[System.String]>
    [<CommonParameters>]

DetailedEEEUParameterSet 

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

Descrizione

Questo cmdlet viene usato per generare report dag che gestiscono la potenziale sovraslocazione di dati sensibili. Questi report sono presenti nell'interfaccia di amministrazione di SharePoint. I report sono attualmente disponibili per gli scenari seguenti:

  • Condivisione di collegamenti creati negli ultimi 28 giorni (chiunque, People-in-your-org, utenti specifici condivisi esternamente).
  • Contenuto condiviso con Tutti tranne gli utenti esterni (EEEU) negli ultimi 28 giorni.
  • Elenco di siti con file etichettati, a partire dal tempo di generazione del report.
  • Elenco di siti con "troppi utenti", a partire dal tempo di generazione del report, per configurare una baseline di sovrasodivisione.
  • Elenco di siti con autorizzazioni dirette o indirette per gli utenti specificati.

Esempio

Esempio 1

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

Il cmdlet precedente genera un elenco di siti di SharePoint a cui possono accedere più di 1000 utenti, a partire dal giorno di generazione del report.

Esempio 2

Start-SPODataAccessGovernanceInsight -ReportEntity EveryoneExceptExternalUsers -ReportType Snapshot

Il cmdlet precedente genera un report dettagliato per tutto il contenuto condiviso con "Tutti tranne gli utenti esterni" (siti, gruppi e file) sia nei siti di SharePoint che negli account di OneDrive, a partire dal tempo di generazione del report.

Parametri

-CountOfUsersMoreThan

Specifica la soglia di oversharing definita dal numero di utenti che possono accedere al sito. Il numero di utenti che possono accedere al sito è determinato dall'espansione di tutti gli utenti, gruppi in tutte le autorizzazioni (a livello di sito e a livello di qualsiasi elemento con autorizzazioni unqiue), deduplicazione e arrivo a un numero univoco. Il valore minimo è 0.

Proprietà dei parametri

Tipo:System.Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SitePermissionsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-FileSensitivityLabelGUID

Specifica il GUID per l'etichetta di riservatezza per il file.

Proprietà dei parametri

Tipo:System.Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

LabelParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-FileSensitivityLabelName

Specifica il nome dell'etichetta di riservatezza per il file.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

LabelParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome da assegnare al report generato.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

EEEUParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
SitePermissionsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
UserPermissionsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Privacy

Specifica l'impostazione di privacy del gruppo di Microsoft 365. Rilevante in caso di filtro del report per i siti connessi al gruppo.

Proprietà dei parametri

Tipo:Microsoft.Online.SharePoint.TenantAdministration.PrivacyEnum
Valore predefinito:None
Valori accettati:All, Private, Public
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

EEEUParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
SitePermissionsParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ReportEntity

Specifica l'entità che potrebbe causare l'oversharing e quindi monitorata da questi report.

Proprietà dei parametri

Tipo:Microsoft.Online.SharePoint.TenantAdministration.ReportEntityEnum
Valore predefinito:None
Valori accettati:Everyone, EveryoneExceptExternalUsers, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, PermissionedUsers, PermissionsReport, SensitivityLabelForFiles, SharingLinks_Anyone, SharingLinks_Guests, SharingLinks_PeopleInYourOrg
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ReportType

Specifica il periodo di tempo dei dati in base al quale viene generato il report del gruppo di disponibilità del database. Un report "Snapshot" includerà i dati più recenti a partire dall'ora di generazione del report. Un report "RecentActivity" si baserà sui dati degli ultimi 28 giorni.

Proprietà dei parametri

Tipo:Microsoft.Online.SharePoint.TenantAdministration.ReportTypeEnum
Valore predefinito:None
Valori accettati:Snapshot, RecentActivity
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SiteSensitivityLabelGUID

Specifica il GUID dell'etichetta di riservatezza applicata al sito.

Proprietà dei parametri

Tipo:

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

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

EEEUParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
SitePermissionsParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Template

Specifica il modello del sito. Rilevante nel caso in cui venga generato un report per quel modello specifico.

Proprietà dei parametri

Tipo:

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

Valore predefinito:None
Valori accettati:AllSites, ClassicSites, CommunicationSites, TeamSites, OtherSites
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

EEEUParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
SitePermissionsParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UserPrincipalNames

Specifica i nomi dell'entità utente degli utenti per i quali deve essere generato il report sulle autorizzazioni.

Proprietà dei parametri

Tipo:

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

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UserPermissionsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Workload

Specifica se il report è per i siti di SharePoint o gli account OneDrive.

Proprietà dei parametri

Tipo:Microsoft.Online.SharePoint.TenantAdministration.WorkloadEnum
Valore predefinito:None
Valori accettati:SharePoint, OneDriveForBusiness
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

EEEUParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
LabelParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
SharingLinkParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
SitePermissionsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
UserPermissionsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

Input

None

Output

System.Object