> ## Documentation Index
> Fetch the complete documentation index at: https://ps365.clidsys.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get-MgSlaCreditEstimate

> Estimates the Microsoft 365 SLA service credit for one or more Service Health incidents and prepares the claim.

# Get-MgSlaCreditEstimate

## SYNOPSIS

Estimates the Microsoft 365 SLA service credit for one or more Service Health incidents and prepares the claim.

## SYNTAX

### Estimate (Default)

```powershell theme={null}
Get-MgSlaCreditEstimate [-IncidentId <string[]>] [-KnownIncident <string[]>]
 [-ServicePrice <hashtable>] [-AffectedUserCount <hashtable>]
 [-Currency <string>] [-OutputFolder <string>] [-ExportToExcel]
```

### List

```powershell theme={null}
Get-MgSlaCreditEstimate -ListIncidents [-Since <datetime>] [-IncludeAdvisory]
 [-ExportToExcel]
```

## DESCRIPTION

Reads the incidents from Microsoft 365 Service Health, merges the incident windows of each service (two
overlapping incidents on the same service are counted once), splits them per calendar month (the SLA
measures uptime per month) and returns, for each service and month, the downtime, the uptime percentage,
the credit tier and the estimated credit.

The credit tiers are the ones of the Microsoft Online Services SLA for the 99.9% services:
below 99.9% uptime 25%, below 99% 50%, below 95% 100% of the monthly fee of the affected service.

The affected users are the enabled users with an active service plan of the affected service
(Exchange Online, SharePoint Online and OneDrive, Microsoft Teams).
Use -AffectedUserCount when only part
of the tenant was affected, or for a service the function cannot map to a service plan.

The credit is computed on the price of the affected service, not on the whole licence: for a suite licence
(Microsoft 365 E3, Business Premium...), pass the share of the price that Microsoft assigns to the service
with -ServicePrice.
Without -ServicePrice for a service, the public list price of its standalone plan is used
(Private/Assets/Get-MgSlaCreditEstimate-list-prices.json, excluding VAT, annual commitment: Exchange Online
Plan 1 and Plan 2 in EUR and USD, Teams Essentials and SharePoint Plan 1 in EUR) when its currency matches
-Currency.
For Exchange Online, each licensed user is priced at the plan of their service plan
(EXCHANGE\_S\_STANDARD = Plan 1, EXCHANGE\_S\_ENTERPRISE = Plan 2, also held by suites such as Microsoft 365 E3),
one row per plan; other Exchange plans (Kiosk, F3...) are priced as Plan 1.
The Plan and PriceSource columns
say which price was used.
Without any price, the credit percentage is returned and
EstimatedCredit stays empty.

With -OutputFolder, the function also writes the incidents, the estimate, the affected users per country,
the post-incident reports that are already published, an incident report in Markdown (incident-report.md:
timeline, impact, Microsoft updates and estimate) and a claim text to paste into the support request
(claim-request.txt, Microsoft 365 admin center > Support > New service request).

The function assumes every affected user was affected for the whole incident window: the estimate is a
ceiling, Microsoft computes the final credit from its own user-minute measurements.

## EXAMPLES

### EXAMPLE 1

```powershell theme={null}
Get-MgSlaCreditEstimate -KnownIncident 'Exchange-2026-11-12' -ServicePrice @{ 'Exchange Online' = 4 }
```

Estimate for the Exchange Online outage of November 12 to 13, 2026, without looking up its incident IDs.

### EXAMPLE 2

```powershell theme={null}
Get-MgSlaCreditEstimate -ListIncidents -Since '2026-11-01'
```

Lists the incidents that started since November 1, 2026, longest first.

### EXAMPLE 3

```powershell theme={null}
Get-MgSlaCreditEstimate -IncidentId 'EX1550543', 'MO1550821' -ServicePrice @{ 'Exchange Online' = 4 }
```

Returns the downtime, uptime, credit tier and estimated credit per service and month.

### EXAMPLE 4

```powershell theme={null}
Get-MgSlaCreditEstimate -IncidentId 'EX1550543' -ServicePrice @{ 'Exchange Online' = 4 } -OutputFolder 'C:\Temp\SLA-claim'
```

Same estimate, plus the CSV files, the post-incident report when published, incident-report.md and claim-request.txt in C:\Temp\SLA-claim.

### EXAMPLE 5

```powershell theme={null}
Get-MgSlaCreditEstimate -IncidentId 'TM1551002' -ServicePrice @{ 'Microsoft Teams' = 3.2 } -AffectedUserCount @{ 'Microsoft Teams' = 120 }
```

Estimate for a Teams incident that affected 120 users only.

### EXAMPLE 6

```powershell theme={null}
Get-MgSlaCreditEstimate -IncidentId 'EX1550543' -ServicePrice @{ 'Exchange Online' = 4 } -ExportToExcel
```

Exports the estimate to an Excel file in the user profile.

## PARAMETERS

### -AffectedUserCount

Number of affected users per service, keyed by the Service Health service name, when it differs from the
licensed users (e.g.
@`{ 'Exchange Online' = 250 }`).

```yaml theme={null}
Type: System.Collections.Hashtable
DefaultValue: '@{}'
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Estimate
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

### -Currency

Currency of the prices, shown in the output and in the claim text.
Default: EUR.

```yaml theme={null}
Type: System.String
DefaultValue: EUR
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Estimate
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

### -ExportToExcel

Exports the estimate to an Excel file in the user profile instead of returning it, with a second worksheet
for the licensed users per country (when the users are counted from the tenant, not from -AffectedUserCount).

```yaml theme={null}
Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

### -IncidentId

One or more Service Health issue IDs (e.g.
EX1550543, MO1550821).

```yaml theme={null}
Type: System.String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Estimate
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

### -IncludeAdvisory

With -ListIncidents, also lists the advisories (minor issues, usually not eligible for a credit).

```yaml theme={null}
Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: List
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

### -KnownIncident

Name of a major outage listed in the module (e.g.
Exchange-2026-11-12): its Service Health IDs are used,
they are the same in every tenant.
Press Tab after -KnownIncident to see the names.
Can be combined with
-IncidentId.

```yaml theme={null}
Type: System.String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Estimate
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

### -ListIncidents

Lists the Service Health incidents that started since -Since, with their service and duration, to pick the
IDs to pass to -IncidentId.
Advisories are left out unless -IncludeAdvisory is set.

```yaml theme={null}
Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: List
  Position: Named
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

### -OutputFolder

Folder for the CSV files, the post-incident reports and the claim text.
Created when missing.

```yaml theme={null}
Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Estimate
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

### -ServicePrice

Monthly price per user of each affected service, keyed by the Service Health service name
(e.g.
@`{ 'Exchange Online' = 4; 'Microsoft Teams' = 3.2 }`).
Overrides the public list price of the service.

```yaml theme={null}
Type: System.Collections.Hashtable
DefaultValue: '@{}'
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Estimate
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

### -Since

With -ListIncidents, the date from which incidents are listed.
Default: 30 days ago.

```yaml theme={null}
Type: System.DateTime
DefaultValue: (Get-Date).AddDays(-30)
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: List
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
```

### CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
[about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

## INPUTS

## OUTPUTS

## NOTES

Required Microsoft Graph scopes: ServiceHealth.Read.All, User.Read.All.
Inspired by LazyAdmin (Rudy Mens): [https://lazyadmin.nl/office-365/claim-microsoft-365-sla-credit-after-an-outage/](https://lazyadmin.nl/office-365/claim-microsoft-365-sla-credit-after-an-outage/)

## RELATED LINKS

* [https://ps365.clidsys.com/docs/commands/Get-MgSlaCreditEstimate](https://ps365.clidsys.com/docs/commands/Get-MgSlaCreditEstimate.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.