Weboldal keresés

Hozzon létre SharePoint Online webhelyhasználati jelentéseket a Graph API és a PowerShell segítségével

Követelmény: Használati jelentéseket hozzon létre a SharePoint Online webhelyekhez.

Hogyan hozhat létre használati jelentéseket az összes SharePoint Online webhelyhez a bérlőben?

Ha Ön SharePoint-rendszergazda, hasznos lehet jelentéseket készíteni arról, hogy a felhasználók hogyan használják a webhelyeket és a tartalmat. A Microsoft megkönnyítette a használati jelentések létrehozását, amelyek olyan statisztikákat tartalmaznak, mint például az összes fájl, a felhasznált tárhely, az oldalmegtekintések stb. Ez a blogbejegyzés bemutatja, hogyan hozhat létre használati jelentéseket a bérlő összes SharePoint Online webhelyéhez. Ezek a jelentések segítségével nyomon követheti és figyelemmel kísérheti a felhasználók tevékenységét a SharePoint-webhelyeken.

A Microsoft 365 felügyeleti portálról a használati adatokat CSV formátumban exportálhatja. Az összes SharePoint Online webhely használati és tevékenységi jelentéseinek lekéréséhez kövesse az alábbi lépéseket:

  1. Nyissa meg a Microsoft 365 Felügyeleti Központot a https://admin.microsoft.com/ címen.
  2. Kattintson a Jelentések >> Használat menüpontra a bal oldali navigációs panelen.
  3. Válassza ki a kívánt jelentést. Például. SharePoint webhelyhasználat.

A SharePoint webhely használati jelentései az elmúlt 7 napról, 30 napról, 90 napról és 180 napról állnak rendelkezésre. A jelentés adatait CSV-fájlba is exportálhatja az Exportálás hivatkozás kiválasztásával.

Hogyan hozhatunk létre használati jelentéseket a Graph API és a PowerShell segítségével?

A Microsoft Graph API egy kommunikációs szolgáltatás, amely az Azure és a Microsoft 365 szolgáltatások között csatlakozik és kezeli az adatokat. A Microsoft Graph API metódusainak meghívásához szükségünk van egy alkalmazásra. Kövesse ezeket a lépéseket új alkalmazás hozzáadásához.

1. lépés: Hozzon létre új alkalmazásregisztrációt az Azure AD-ben

A Microsoft Graph API-k használatához először regisztrálnia kell egy alkalmazást.

  1. Jelentkezzen be az Azure Active Directoryba a https://portal.azure.com címen. >> Nyissa meg az „Azure Active Directory”-t >> Kattintson az „Alkalmazásregisztrációk” elemre a bal oldali navigációs panelen.

  2. Kattintson az „Új regisztráció” lehetőségre >> Adjon nevet az alkalmazásának, válassza ki a „Ki használhatja ezt az alkalmazást vagy férhet hozzá ehhez az API-hoz?”, Új alkalmazás hozzáadásához kattintson az alján található „Regisztráció” gombra.

2. lépés: Adjon engedélyt az alkalmazásnak

Az alkalmazás létrehozása után a következő lépés a használati jelentések olvasásához szükséges engedélyek megadása.

  1. Az Alkalmazásregisztráció oldalon nyissa meg az imént létrehozott alkalmazást >> Kattintson az „API engedélyek” elemre.

  2. Kattintson az „Engedély hozzáadása” elemre >> Válassza a „Microsoft Graph” lehetőséget. >> Válassza az „Alkalmazásengedélyek” lehetőséget. >> A Jelentések alatt válassza a „Reports.Read.All” lehetőséget>> Kattintson az „Engedélyek hozzáadása” elemre.

Előfordulhat, hogy más engedélyt kell kiválasztania attól függően, hogy mit szeretne elérni. A Microsoft Graph API szinte minden részletet lekérdezhet az Azure AD-ből vagy más Office 365-szolgáltatásokból.

Hozzájárulás az alkalmazáshoz

Az alkalmazásengedély használatához rendszergazdai hozzájárulás szükséges a bérlőben. Hozzon létre egy hozzájárulási URL-t, például az alábbiak szerint:

  • Válassza a „Reports.Read.All” lehetőséget, majd kattintson egyszer a „Adminisztrátori hozzájárulás megadása a <Ön-Bérlő> számára” gombra.

3. lépés: Adja hozzá az ügyféltitkot

Utolsó lépésként szükségünk van egy titkos ügyfélkulcsra az alkalmazáshoz társítva.

  1. Az Alkalmazás oldalon kattintson a „Tanúsítványok és titkok” hivatkozásra a bal oldali navigációs sávban. Kattintson az „Új ügyfél titkossága” gombra. Válassza ki az alkalmazás érvényességi idejét, és hozzon létre egy titkos ügyfélkulcsot.

PowerShell to Call Graph API módszer a használati jelentések lekéréséhez

Miután az alkalmazás készen áll, másolja és illessze be az ügyfél-azonosítót, a titkosságot és az egyéb paramétereket ebbe a szkriptbe, és futtassa. Hozzon létre használati jelentéseket SharePoint Online webhelyeihez a Graph API és a PowerShell segítségével:


#Function to Call Graph API
Function Get-UsageReport {
param (
    [parameter(Mandatory = $true)] [string]$ClientID,
    [parameter(Mandatory = $true)] [string]$ClientSecret,
    [parameter(Mandatory = $true)] [string]$TenantName, 
    [parameter(Mandatory=$true)] [string]$GraphUrl
)
    Try {
        #Graph API URLs
        $LoginUrl = "https://login.microsoft.com"
        $ResourceUrl = "https://graph.microsoft.com"
 
        #Compose REST request
        $Body = @{ grant_type = "client_credentials"; resource = $ResourceUrl; client_id = $ClientID; client_secret = $ClientSecret }
        $OAuth = Invoke-RestMethod -Method Post -Uri $LoginUrl/$TenantName/oauth2/token?api-version=1.0 -Body $Body
 
        #Perform REST call
        $HeaderParams = @{ 'Authorization' = "$($OAuth.token_type) $($OAuth.access_token)" }
        $Result = (Invoke-WebRequest -UseBasicParsing -Headers $HeaderParams -Uri $GraphUrl)

        #Format Microsoft Graph Output
        (($Result).RawContent -Split "\?\?\?")[1] | ConvertFrom-Csv
    }    
    Catch {
        Write-host "Error: $($_.Exception.Message)" -foregroundcolor Red
    }
}

#Parameters
$ClientID = "98ax2c6d2-264c-424e-b911-c33x547de5211"
$ClientSecret = "T1ZP3-a_NIoA4cej2xky.2xaDcF..6E5"
$TenantName = "crescentintranet.onmicrosoft.com"
$GraphUrl = "https://graph.microsoft.com/v1.0/reports/getSharePointSiteUsageDetail(period='D30')"

#Call the function to get usage data
$UsageData = Get-UsageReport -ClientID $ClientID -ClientSecret $ClientSecret -TenantName $TenantName -GraphUrl $GraphUrl
$UsageData
$UsageData | Export-Csv "C:\Temp\siteusage.csv" -NoTypeInformation

Ez a PowerShell-szkript a következőképpen hoz létre egy CSV-jelentést:

Microsoft Graph REST API referencia https://docs.microsoft.com/en-us/graph/api/resources/sharepoint-activity-reports?view=graph-rest-1.0

Kapcsolódó cikkek