--- updatedAt: 2026-05-14T21:43:24.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/powershell/llms.txt --- # Property Copy-Property ## Synopsis Create or clone a property. ## Syntax ```powershell Name & attributes (Default) Copy-Property -Name -ProductID [-RuleFormat ] -ClonePropertyName -ClonePropertyVersion [-ClonePropertyVersionEtag ] [-CopyHostnames] [-UseHostnameBucket] -GroupID -ContractID [-EdgeRCFile ] [-Section ] [-AccountSwitchKey ] [-ProgressAction ] [] ``` ```powershell ID & attributes Copy-Property -Name -ProductID [-RuleFormat ] -ClonePropertyID -ClonePropertyVersion [-ClonePropertyVersionEtag ] [-CopyHostnames] [-UseHostnameBucket] -GroupID -ContractID [-EdgeRCFile ] [-Section ] [-AccountSwitchKey ] [-ProgressAction ] [] ``` ```powershell Body Copy-Property -Body -GroupID -ContractID [-EdgeRCFile ] [-Section ] [-AccountSwitchKey ] [-ProgressAction ] [] ``` ## Description This operation either creates a new property from scratch or bases one on another property's rule tree and optionally its set of assigned hostnames. Version 1 of a new property is created automatically. PAPI's ability to create and clone new properties means that you can design a system of rule templates targeted to specific domains, rather than maintain a single set of rules with conditional logic for your full range of domains. Maintaining properties manually within the Control Center interface limited you to that more consolidated approach, but you can deploy rules more efficiently using PAPI. In either case, PAPI makes it much easier for you to support a large, flexible set of domains. ## Parameters
‑AccountSwitchKey
String Pipeline input: False

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 Get-AccountSwitchKey.
‑Body
Conditionally required
Object Parameter sets: Body Pipeline input: ByValue

A request body, either as a PSCustomObject or a string. This parameter supports pipelining.
‑ClonePropertyID
Conditionally required
String Parameter sets: ID & attributes Pipeline input: False

The ID of the property to clone. If cloning a property, provide this or the -ClonePropertyName.
‑ClonePropertyName
Conditionally required
String Parameter sets: Name & attributes Pipeline input: False

The name of the property to clone. If cloning a property, provide this or the -ClonePropertyID.
‑ClonePropertyVersion
Conditionally required
String Parameter sets: ID & attributes, Name & attributes Pipeline input: False

The version of the property to clone. Can be an integer or the word latest.
‑ClonePropertyVersionEtag
String Parameter sets: ID & attributes, Name & attributes Pipeline input: False

Performs an ETag data integrity check on the original property version to ensure no edits have occurred since your last check.
‑ContractID
Required
String Pipeline input: False

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 -GroupID. This parameter is optional except for the create requests.
‑CopyHostnames
Switch Parameter sets: ID & attributes, Name & attributes Pipeline input: False

Assigns the same set of hostnames to the new property.
‑EdgeRCFile
String Pipeline input: False

Your EdgeGrid resource file to authenticate your command. Defaults to ~/.edgerc.
‑GroupID
Required
String Pipeline input: False

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 -ContractID. This parameter is optional except for the create requests.
‑Name
Conditionally required
String Parameter sets: ID & attributes, Name & attributes Pipeline input: False

A human-readable name you give to identify your property.
‑ProductID
Conditionally required
String Parameter sets: ID & attributes, Name & attributes Pipeline input: False

The product's ID.
‑RuleFormat
String Parameter sets: ID & attributes, Name & attributes Pipeline input: False

The name of the rule format. The rule format can be frozen to a specific version, or represent the latest set of behaviors and criteria. You can retrieve rule formats with Get-RuleFormat.
‑Section
String Pipeline input: False

The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to default.
‑UseHostnameBucket
Switch Parameter sets: ID & attributes, Name & attributes Pipeline input: False

When the switch is present, this creates a special type of property where you can add or remove property hostnames without incrementing property versions. Generally used for properties with > 1000 hostnames.
## Related Links * [User Guide: Property](https://techdocs.akamai.com/powershell/docs/property-manager) * [API Reference](https://techdocs.akamai.com/property-mgr/reference/post-properties) # Sibling pages * [Include](https://techdocs.akamai.com/powershell/docs/copy-propertyinclude.md)