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

# Configuration evaluation hostnames

Protect-AppSecEvaluationHostnames

## Synopsis

Protect evaluation hostnames.

## Syntax

```powershell Config name by pipeline (Default)
Protect-AppSecEvaluationHostnames [-ConfigName] <String> [-VersionNumber] <String> -Body <Object> [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
```
```powershell Config name & attributes
Protect-AppSecEvaluationHostnames [-ConfigName] <String> [-VersionNumber] <String> -Hostnames <String[]> -Mode <String> [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
```
```powershell Config ID by pipeline
Protect-AppSecEvaluationHostnames -ConfigID <Int32> [-VersionNumber] <String> -Body <Object> [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
```
```powershell Config ID & attributes
Protect-AppSecEvaluationHostnames -ConfigID <Int32> [-VersionNumber] <String> -Hostnames <String[]> -Mode <String> [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
```

## Description

Moves hostnames you're evaluating to active protection in a specified configuration version.

When you move a hostname from the evaluation hostnames list, it's added to your security policy as a protected hostname.

You can provide `-Hostnames` and `-Mode` as individual parameters or all at once with the `-Body` parameter.

When making a request, you can specify a configuration by its name or ID.

The `-VersionNumber` parameter is an integer or the word `latest`.

## 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;Body</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">Object</span>
          <span class="ps-param-metadata">Parameter sets: <code>Config ID by pipeline</code>, <code>Config name by pipeline</code></span>
          <span class="ps-param-metadata">Pipeline input: ByValue</span>
        </div>
        <div>
          <p>The request body, either as a <code>PSCustomObject</code> or a string. This parameter supports pipelining.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;ConfigID</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>Config ID by pipeline</code>, <code>Config ID & attributes</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>Your configuration's ID.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;ConfigName</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">String</span>
          <span class="ps-param-metadata">Parameter sets: <code>Config name by pipeline</code>, <code>Config name & attributes</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>The name of your security configuration.</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;Hostnames</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">Object</span>
          <span class="ps-param-metadata">Parameter sets: <code>Config ID & attributes</code>, <code>Config name & attributes</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>List of hostnames to be added to the configuration.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;Mode</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">String</span>
          <span class="ps-param-metadata">Accepted values: <code>append</code>, <code>remove</code>, <code>replace</code></span>
          <span class="ps-param-metadata">Parameter sets: <code>Config ID & attributes</code>, <code>Config name & attributes</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>The type of update you want to make to the evaluation hostname list. You can <code>append</code> additional hostnames, <code>remove</code> hostnames from the list, or <code>replace</code> the existing list with the hostnames you pass in your request.</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;VersionNumber</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>A configuration's version. Can be an integer or the word <code>latest</code>.</p>
        </div>
      </td>
    </tr>
  </tbody>
</table>

## Related Links

* [User Guide: Overview](https://techdocs.akamai.com/powershell/docs/overview)
* [API Reference](https://techdocs.akamai.com/application-security/reference/put-protect-eval-hostnames)

# Sibling pages

* [Policy evaluation hostnames](https://techdocs.akamai.com/powershell/docs/protect-appsecpolicyevaluationhostnames.md)