Property activation

New-PropertyActivation

Synopsis

Activate a property.

Syntax

New-PropertyActivation [-PropertyName] <String> -PropertyVersion <String> -Network <String> [-Note <String>] [-UseFastFallback] -NotifyEmails <Object> [-GroupID <String>] [-ContractId <String>] [-NoncomplianceReason <String>] [-OtherNoncomplianceReason <String>] [-CustomerEmail <String>] [-PeerReviewedBy <String>] [-UnitTested] [-TicketID <String>] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
New-PropertyActivation [-PropertyName] <String> -Body <Object> [-GroupID <String>] [-ContractId <String>] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
New-PropertyActivation -PropertyID <String> -Body <Object> [-GroupID <String>] [-ContractId <String>] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
New-PropertyActivation -PropertyID <String> -PropertyVersion <String> -Network <String> [-Note <String>] [-UseFastFallback] -NotifyEmails <Object> [-GroupID <String>] [-ContractId <String>] [-NoncomplianceReason <String>] [-OtherNoncomplianceReason <String>] [-CustomerEmail <String>] [-PeerReviewedBy <String>] [-UnitTested] [-TicketID <String>] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Activates a specific version of a property on either the staging or production network. Within an hour of activating, you can optionally add the -UseFastFallback switch to roll back to the previous active version more quickly.

Parameters

‑AccountSwitchKey

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

A request body, either as a PSCustomObject or a string. This parameter supports pipelining.

‑ContractId

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.

‑CustomerEmail

The customer email attribute of a complianceRecord. Generally, only used by Akamai internal users.

‑EdgeRCFile

Your EdgeGrid resource file to authenticate your command. Defaults to ~/.edgerc.

‑GroupID

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.

‑Network
Conditionally required

The network to activate on, either STAGING or PRODUCTION.

‑NoncomplianceReason

A reason to include in the complianceRecord. Generally, only used by Akamai internal users. Otherwise, can be ignored.

‑Note

A descriptive message about the activation request.

‑NotifyEmails
Conditionally required

One or more email addresses to notify when the activation status changes.

‑OtherNoncomplianceReason

A free text field to include if the options for the -NoncomplianceReason aren't sufficient. Generally, only used by Akamai internal users. Otherwise, can be ignored.

‑PeerReviewedBy

ID of the reviewing user. Generally only used by Akamai internal users. Can be ignored otherwise.

‑PropertyID
Conditionally required

Your property's ID. Commonly, you only need to specify either -PropertyName or -PropertyID.

‑PropertyName
Conditionally required

A human-readable name for your property. Commonly, you only need to specify either -PropertyName or -PropertyID.

‑PropertyVersion
Conditionally required

Property's incremental version number. Can be an integer or the word latest.

‑Section

The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to default.

‑TicketID

The Siebel ticket ID to include in the complianceRecord. Generally, only used by Akamai internal users. Otherwise, can be ignored.

‑UnitTested

A switch to indicate unit testing has been carried out. Part of the complianceReason and generally only used by Akamai internal users. Otherwise, can be ignored.

‑UseFastFallback

After activating a property and finding it causes problems, submitting another activation within one hour with the -UseFastFallback enabled quickly rolls back to the previous version. This option is only available for activations where canFastFallback is true.

Related Links