Resource

Set-GTMResource

Synopsis

Create or update a resource.

Syntax

Set-GTMResource [-DomainName] <String> [-ResourceName] <String> [-Body] <Object> [[-EdgeRCFile] <String>] [[-Section] <String>] [[-AccountSwitchKey] <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Creates or updates a resource. This function is identical to the New-GTMResource operation. If the specified resource doesn't already exist, it'll be created.

Note: Due to the complexity of the request body, it's recommended that you pull down the existing resource, edit it locally, and pipe the object to this function.

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
Required

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

‑DomainName
Required

The full GTM domain name.

‑EdgeRCFile

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

‑ResourceName
Required

The name of the resource.

‑Section

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

Related Links