Activations
New-AppSecActivation
Synopsis
Activate a configuration version.
Syntax
New-AppSecActivation [-ConfigName] <String> -VersionNumber <String> -Network <String> -NotificationEmails <String> [-Note <String>] [-AcknowledgedInvalidHosts <String>] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
New-AppSecActivation -ConfigID <Int32> -VersionNumber <String> -Network <String> -NotificationEmails <String> [-Note <String>] [-AcknowledgedInvalidHosts <String>] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
New-AppSecActivation -Body <Object> [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
Description
Activates one or more configurations globally.
Note that you need to explicitly list any invalid hosts in the -AcknowledgedInvalidHosts
parameter to successfully activate a configuration that includes invalid hostnames.
You can choose to provide activation settings individually, but, by doing so, the command can only activate a single configuration. To activate multiple configurations at once, you need to use the -Body
parameter and provide the request body as a string or PSCustomObject
.
When making a request, you can specify a configuration with the -ConfigName
or -ConfigID
parameter. The -VersionNumber
parameter is an integer or the word latest
.
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. |
‑AcknowledgedInvalidHosts |
The list of invalid hostnames in the security configuration to activate. In some cases, you may want to activate a security configuration with hostnames that WAF can't protect (for example, hostnames not managed as Akamai properties, or managed under a different contract than the configuration) |
‑Body Conditionally required |
The request body, either as a |
‑ConfigID Conditionally required |
Your configuration's ID. |
‑ConfigName Conditionally required |
The name of your security configuration. |
‑EdgeRCFile |
Your EdgeGrid resource file to authenticate your command. Defaults to |
‑Network Conditionally required |
The target Akamai activation environment, either |
‑Note |
The notes you entered for the activation. |
‑NotificationEmails Conditionally required |
The email addresses to notify when the activation happens. |
‑Section |
The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to |
‑VersionNumber Conditionally required |
A configuration's version. Can be an integer or the word |
Related Links
Updated 9 days ago