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

# Property hostname

Add-PropertyHostname

## Synopsis

Add hostnames to a property version.

## Syntax

```powershell Name (Default)
Add-PropertyHostname [-PropertyName] <String> [-PropertyVersion] <String> -NewHostnames <Object[]> [-GroupID <String>] [-ContractId <String>] [-IncludeCertStatus] [-ValidateHostnames] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
```
```powershell ID
Add-PropertyHostname -PropertyID <String> [-PropertyVersion] <String> -NewHostnames <Object[]> [-GroupID <String>] [-ContractId <String>] [-IncludeCertStatus] [-ValidateHostnames] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
```

## Description

Adds one or more hostnames to a property version.

The `-PropertyVersion` you provide in this operation needs to be `INACTIVE` on both the production and staging networks.

To see the format of hostnames to add, it's recommended that you run the `Get-PropertyHostname` operation and clone the object from the returned data.

## 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. The parameter is optional if a property belongs to only one contract; otherwise, you need to specify it along with the <code>-GroupID</code>. This parameter is optional except for the create requests.</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;GroupID</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 group's ID. The parameter is optional if a property belongs to only one group, otherwise you need to specify it along with the <code>-ContractID</code>. This parameter is optional except for the create requests.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;IncludeCertStatus</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">Switch</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>When enabled, the response includes the certificate status for the hostname on staging and production networks.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;NewHostnames</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">Object[]</span>
          <span class="ps-param-metadata">Pipeline input: ByValue</span>
        </div>
        <div>
          <p>An array of hostnames to be added. Each entry needs to contain these members: <code>cnameFrom</code>, <code>cnameType</code>, <code>edgeHostnameId</code>, and <code>certProvisioningType</code>.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;PropertyID</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>ID</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>Your property's ID. Commonly, you only need to specify either <code>-PropertyName</code> or <code>-PropertyID</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>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>Name</code></span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>A human-readable name for your property. Commonly, you only need to specify either <code>-PropertyName</code> or <code>-PropertyID</code>.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;PropertyVersion</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>Property's incremental version number. Can be an integer or the word <code>latest</code>.</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;ValidateHostnames</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">Switch</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>When enabled, runs validation tests that would identify potential hostname-related problems within the response object's <code>errors</code> and <code>warnings</code> arrays.</p>
        </div>
      </td>
    </tr>
  </tbody>
</table>

## Related Links

* [User Guide: Property](https://techdocs.akamai.com/powershell/docs/property-manager)
* [API Reference](https://techdocs.akamai.com/property-mgr/reference/patch-property-version-hostnames)

# Sibling pages

* [Bucket hostname](https://techdocs.akamai.com/powershell/docs/add-buckethostname.md)
* [Include rule](https://techdocs.akamai.com/powershell/docs/add-propertyincluderule.md)
* [Property rule](https://techdocs.akamai.com/powershell/docs/add-propertyrule.md)