---
updatedAt: 2026-05-27T09:35:05.000Z
agentTools:
  siteIndex: https://techdocs.akamai.com/llms.txt
  projectIndex: https://techdocs.akamai.com/powershell/llms.txt
---

# Test suite

Get-TestSuite

## Synopsis

Get a test suite with child objects.

## Syntax

```powershell all (Default)
Get-TestSuite [-IncludeRecentlyDeleted] [-PropertyID <Int32>] [-PropertyName <String>] [-PropertyVersion <Int32>] [-User <String>] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
```
```powershell single
Get-TestSuite -TestSuiteID <Int32> [-IncludeChildObjects] [-ResolveVariables] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
```

## Description

Gets all test suites in your account or retrieves a specific test suite by its ID.

## 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;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;IncludeChildObjects</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">Switch</span>
          <span class="ps-param-metadata">Parameter sets: <code>single</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>When enabled, includes child objects such as test cases and variables in the result.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;IncludeRecentlyDeleted</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">Switch</span>
          <span class="ps-param-metadata">Parameter sets: <code>all</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>When enabled, includes items deleted within the last 30 days, which you can restore.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;PropertyID</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">Int32</span>
          <span class="ps-param-metadata">Parameter sets: <code>all</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>The ID of the property associated with the test suite to filter the list by. You can combine this parameter with <code>-PropertyVersion</code>. Use either this parameter or <code>-PropertyName</code> to specify the property.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;PropertyName</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Parameter sets: <code>all</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>The name of the property associated with a test suite to filter the list by. You can combine this parameter with <code>-PropertyVersion</code>. Use either this parameter or <code>-PropertyID</code> to specify the property.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;PropertyVersion</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">Int32</span>
          <span class="ps-param-metadata">Parameter sets: <code>all</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>The version of the associated property to filter the test suites by. Combine this parameter with <code>-PropertyID</code> or <code>-PropertyName</code>.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;ResolveVariables</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">Switch</span>
          <span class="ps-param-metadata">Parameter sets: <code>single</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>When enabled, returns test cases with resolved variables assigned statically.</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;TestSuiteID</code><br/><span style="color: red; padding-left: 11px; font-size: 13px;"><em>Conditionally required</em></span></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">Int32</span>
          <span class="ps-param-metadata">Parameter sets: <code>single</code></span>
          <span class="ps-param-metadata">Pipeline input: ByPropertyName, ByValue</span>
        </div>
        <div>
          <p>Your test suite's ID.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;User</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Parameter sets: <code>all</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>Filters the list to items created, edited, or deleted by a specific username.</p>
        </div>
      </td>
    </tr>
  </tbody>
</table>

## Related Links

* [User Guide: Test Center](https://techdocs.akamai.com/powershell/docs/manage-tests)
* [API Reference](https://techdocs.akamai.com/test-ctr/reference/get-test-suites-with-child-objects)

# Sibling pages

* [Test case](https://techdocs.akamai.com/powershell/docs/get-testcase.md)
* [Test catalog template](https://techdocs.akamai.com/powershell/docs/get-testcatalogtemplate.md)
* [Test condition](https://techdocs.akamai.com/powershell/docs/get-testcondition.md)
* [Test request](https://techdocs.akamai.com/powershell/docs/get-testrequest.md)
* [Test run](https://techdocs.akamai.com/powershell/docs/get-testrun.md)
* [Test run results](https://techdocs.akamai.com/powershell/docs/get-testrunresults.md)
* [Test variable](https://techdocs.akamai.com/powershell/docs/get-testvariable.md)