Start-SPODataAccessGovernanceInsight

Modulo:
Microsoft.Online.SharePoint.PowerShell Module

Questo cmdlet genera report Data Access Governance (DAG) destinati a fornire informazioni dettagliate sulla potenziale condivisione eccessiva di dati sensibili in SharePoint e/o OneDrive for Business. Per eseguire questi report è necessaria una licenza di SharePoint Advanced Management (SAM).

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 del gruppo di disponibilità del database che gestiscono la potenziale condivisione eccessiva di dati sensibili. Questi report sono presenti nell'interfaccia di amministrazione di SharePoint. Sono attualmente disponibili report per gli scenari seguenti:

  • Condivisione dei collegamenti creati negli ultimi 28 giorni (Chiunque, People-in-your-org, Persone specifiche condivise esternamente).
  • Contenuto condiviso con tutti tranne gli utenti esterni (EEEU) negli ultimi 28 giorni.
  • Elenco dei siti con file etichettati, al momento della generazione del report.
  • Elenco di siti con "troppi utenti", al momento della generazione del report, per configurare una linea di base di condivisione eccessiva.
  • Elenco di siti con autorizzazioni dirette o indirette a determinati utenti.

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 al giorno della 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) tra siti di SharePoint e account di OneDrive, al momento della generazione del report.

Parametri

-CountOfUsersMoreThan

Specifica la soglia di condivisione eccessiva definita dal numero di utenti che possono accedere al sito. Il numero di utenti che possono accedere al sito è determinato espandendo tutti gli utenti, i gruppi in tutte le autorizzazioni (a livello di sito e a livello di qualsiasi elemento con autorizzazioni unqiue), deduplicando e arrivando 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 rapporto 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 la condivisione eccessiva e quindi monitorata da questi rapporti.

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" conterrà i dati più recenti al momento della 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 sia necessario generare un report per quel particolare modello.

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 delle 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 è destinato ai siti di SharePoint o agli account di 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