---
updatedAt: 2026-05-11T22:25:54.000Z
agentTools:
  siteIndex: https://techdocs.akamai.com/llms.txt
  projectIndex: https://techdocs.akamai.com/powershell/llms.txt
---

# Liveness tests per property

Get-GTMLivenessPerProperty

## Synopsis

Get reports on liveness tests per property.

## Syntax

```powershell
Get-GTMLivenessPerProperty [-DomainName] <String> [-PropertyName] <String> [-Date] <String> [[-AgentIP] <String>] [[-TargetIP] <String>] [[-EdgeRCFile] <String>] [[-Section] <String>] [[-AccountSwitchKey] <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
```

## Description

Retrieves a collection of reports containing logs of individual liveness tests that have failed.

Liveness tests are run periodically by web agents installed in customer data centers.

Liveness scores are used by GTM to decide whether a data center is alive or not.

Liveness tests that fail in succession (tests that run from the same testing agent to the same origin server, which fail with the same error code) are grouped together and represented with a duration.

This duration value is in seconds and can sustain for up to 86400 seconds (one day).

If it crosses that boundary, GTM logs it as a new failure at the beginning of the next day (00:00 UTC), with the duration reset to that point.

## Parameters

<table>
  <tbody>
    <tr>
      <td class="ps-td"><code>&#8209;AccountSwitchKey</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>An account credential key that lets you move between accounts when using an API client enabled for multiple accounts. To find account switch keys, use <a href="https://techdocs.akamai.com/powershell/docs/get-accountswitchkey">Get-AccountSwitchKey</a>.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;AgentIP</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>Filters results by Agent IP.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;Date</code><br/><span style="color: red; padding-left: 11px; font-size: 13px;"><em>Required</em></span></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>The date of a report, in ISO 8601 format of <code>YYYY-MM-DD</code>.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;DomainName</code><br/><span style="color: red; padding-left: 11px; font-size: 13px;"><em>Required</em></span></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>The full GTM domain name.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;EdgeRCFile</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>Your EdgeGrid resource file to authenticate your command. Defaults to <code>~/.edgerc</code>.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;PropertyName</code><br/><span style="color: red; padding-left: 11px; font-size: 13px;"><em>Required</em></span></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>The name of Traffic Management property.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;Section</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to <code>default</code>.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;TargetIP</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>Filters results by Target IP.</p>
        </div>
      </td>
    </tr>
  </tbody>
</table>

## Related Links

* [User Guide: Overview](https://techdocs.akamai.com/powershell/docs/overview)
* [API Reference](https://techdocs.akamai.com/gtm-reporting/reference/get-liveness-tests-property)

# Sibling pages

* [AS map](https://techdocs.akamai.com/powershell/docs/get-gtmasmap.md)
* [CIDR map](https://techdocs.akamai.com/powershell/docs/get-gtmcidrmap.md)
* [Contract](https://techdocs.akamai.com/powershell/docs/get-gtmcontract.md)
* [Datacenter](https://techdocs.akamai.com/powershell/docs/get-gtmdatacenter.md)
* [Datacenter latency](https://techdocs.akamai.com/powershell/docs/get-gtmdatacenterlatency.md)
* [Demand](https://techdocs.akamai.com/powershell/docs/get-gtmdemand.md)
* [Domain](https://techdocs.akamai.com/powershell/docs/get-gtmdomain.md)
* [Domain authorities](https://techdocs.akamai.com/powershell/docs/get-gtmdomainauthority.md)
* [Domain history](https://techdocs.akamai.com/powershell/docs/get-gtmdomainhistory.md)
* [Domain list](https://techdocs.akamai.com/powershell/docs/get-gtmdomainlist.md)
* [Domain status](https://techdocs.akamai.com/powershell/docs/get-gtmdomainstatus.md)
* [Domain summary](https://techdocs.akamai.com/powershell/docs/get-gtmdomainsummary.md)
* [Geo map](https://techdocs.akamai.com/powershell/docs/get-gtmgeomap.md)
* [Group](https://techdocs.akamai.com/powershell/docs/get-gtmgroup.md)
* [Identity](https://techdocs.akamai.com/powershell/docs/get-gtmidentity.md)
* [IP availability per property](https://techdocs.akamai.com/powershell/docs/get-gtmipavailability.md)
* [Liveness test error](https://techdocs.akamai.com/powershell/docs/get-gtmlivenesstesterror.md)
* [Load data](https://techdocs.akamai.com/powershell/docs/get-gtmloaddata.md)
* [Load feedback report](https://techdocs.akamai.com/powershell/docs/get-gtmloadfeedbackreport.md)
* [Property](https://techdocs.akamai.com/powershell/docs/get-gtmproperty.md)
* [Resource](https://techdocs.akamai.com/powershell/docs/get-gtmresource.md)
* [Traffic report per datacenter](https://techdocs.akamai.com/powershell/docs/get-gtmtrafficperdatacenter.md)
* [Traffic report per property](https://techdocs.akamai.com/powershell/docs/get-gtmtrafficperproperty.md)