Skip to main content

Overview

This document describes the process of writing the ProVal Stack Machine Custom Fields to a new client environment.

Requirements

  • VSAAPI ProVal Module

Process

The VSAAPI module is used to interface with the client environment, setting new CustomFields for the Machine Scope.

Payload Usage

./Initialize-VsaAgentFields.ps1 -BaseURL https://vsa.provaltech.com -VsaUserName apiServiceAccount -RestApiToken abcd-efgh-ijkl-mnop

Parameters

ParameterRequiredTypeDescription
BaseURLTrueStringURL of the target VSA environment
VsaUserNameTrueStringVSA user with system role/scope and API access
RestApiTokenTrueStringREST API access token for the VSA user above

Output

  • Initialize-VsaAgentFields-Log.txt
  • Initialize-VsaAgentFields-error.txt

NOTE: This can be run from VSA 9.5 by executing the Agent Procedure: Shared > VSA Automation > Stack CF Initialization.