---
updatedAt: 2026-03-01T18:20:53.000Z
agentTools:
  siteIndex: https://techdocs.akamai.com/llms.txt
  projectIndex: https://techdocs.akamai.com/powershell/llms.txt
---

# Policy

Get-IVMPolicy

## Synopsis

Get a policy.

## Syntax

```powershell
Get-IVMPolicy [-PolicySetID] <String> [[-PolicyID] <String>] [-Network] <String> [[-ContractID] <String>] [[-EdgeRCFile] <String>] [[-Section] <String>] [[-AccountSwitchKey] <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
```

## Description

Gets all policies assigned to a specified policy set or returns a specific policy by its ID.

> **Note:** If your account has multiple IVM-enabled contracts, you need to specify the contract 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;ContractID</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 contract's ID.</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;Network</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">Accepted values: <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Staging</code>, <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">Production</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>A type of network to execute the API request on, either <code>Staging</code> or <code>Production</code>.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;PolicyID</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 image or video policy's ID. To get a policy's ID, run <code>Get-IVMPolicy</code>. Use in conjunction with the <code>-Url</code>, <code>-TransformationType</code>, and <code>-Size</code> parameters.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;PolicySetID</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>Your policy set's ID.</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>
  </tbody>
</table>

## Related Links

* [User Guide: Image & Video Manager](https://techdocs.akamai.com/powershell/docs/add-and-maintain-policy-rules)
* [API Reference](https://techdocs.akamai.com/ivm/reference/get-policy)

# Sibling pages

* [Error details](https://techdocs.akamai.com/powershell/docs/get-ivmerrordetails.md)
* [Image](https://techdocs.akamai.com/powershell/docs/get-ivmimage.md)
* [Log details](https://techdocs.akamai.com/powershell/docs/get-ivmlogdetails.md)
* [Policy history](https://techdocs.akamai.com/powershell/docs/get-ivmpolicyhistory.md)
* [Policy set](https://techdocs.akamai.com/powershell/docs/get-ivmpolicyset.md)