Get-SPOTenantLogEntry

Retrieves SharePoint Online company logs. This cmdlet is reserved for internal Microsoft use.

Syntax

Get-SPOTenantLogEntry
   [[-StartTimeInUtc] <DateTime>]
   [[-EndTimeInUtc] <DateTime>]
   [[-MaxRows] <UInt32>]
   -CorrelationId <Guid>
   [<CommonParameters>]
Get-SPOTenantLogEntry
   [[-StartTimeInUtc] <DateTime>]
   [[-EndTimeInUtc] <DateTime>]
   [[-MaxRows] <UInt32>]
   -Source <Int32>
   [<CommonParameters>]
Get-SPOTenantLogEntry
   [[-StartTimeInUtc] <DateTime>]
   [[-EndTimeInUtc] <DateTime>]
   [[-MaxRows] <UInt32>]
   -User <String>
   [<CommonParameters>]

Description

This cmdlet contains more than one parameter set. You may only use parameters from one parameter set and you may not combine parameters from different parameter sets. For more information about how to use parameter sets, see Cmdlet Parameter Sets.

The Get-SPOTenantLogEntry cmdlet cannot retrieve all SharePoint Online errors. This cmdlet retrieves a subset of errors that happen due to external systems.

For Beta 2, the only company logs available are for Business Connectivity Services (BCS).

Note

If you do not use any parameter, the first 1000 rows in descending time range are returned.

You must be a SharePoint Online administrator or Global Administrator to run the cmdlet.

For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at Intro to SharePoint Online Management Shell.

Examples

-----------------------EXAMPLE 1-----------------------------

Get-SPOTenantLogEntry

This example retrieves all logs that are available.

-----------------------EXAMPLE 2-----------------------------

Get-SPOTenantLogEntry -MaxRows 500

This example retrieves the first 500 log entries.

-----------------------EXAMPLE 3-----------------------------

$endTimeinUTC = Get-SPOTenantLogLastAvailableTimeInUtc
$startTimeinUTC = $endTimeinUTC.AddDays(-14)
$tenantlogs = Get-SPOTenantLogEntry -StartTimeinUtc $startTimeinUTC -EndTimeinUTC $endTimeinUTC

This example retrieves log entries recorded over that previous 14 days.

-----------------------EXAMPLE 4-----------------------------

$endTimeinUTC = Get-SPOTenantLogLastAvailableTimeInUtc
$startTimeinUTC = $endTimeinUTC.AddDays(-14)
$tenantlogs = Get-SPOTenantLogEntry -StartTimeinUtc $startTimeinUTC -EndTimeinUTC $endTimeinUTC -CorrelationId e2c2be70-6382-4ce7-8a44-ae7dadff5597

This example retrieves log entries recorded over that previous 14 days that have the CorrelationId of "e2c2be70-6382-4ce7-8a44-ae7dadff5597".

Parameters

-CorrelationId

Specifies the Correlation ID as a filter.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-EndTimeInUtc

Specifies the end time in UTC to search for logs.

Type:DateTime
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-MaxRows

Specifies the maximum number of rows in the descending order of timestamp. The value must be less than 5000. The default value is 1000.

Type:UInt32
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Source

Specifies the component that logs the errors.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-StartTimeInUtc

Specifies the start time in Coordinated Universal Time (UTC) to search for the logs (for example, 01032011:12:00).

Type:DateTime
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-User

Specifies the log-on identity as a filter.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

Inputs

None

Outputs

System.Object