PowerShell utilities and connection patterns for working with AVEVA / OSIsoft PI systems using AFSDK.

This repository focuses on practical scripting patterns for:

• PI Data Archive connections
• Asset Framework (AF) connections
• Reading & comparing PI tag values
• Reusable PowerShell helpers for industrial environments

The goal is to document clear and transferable patterns for engineers working with PI systems.

There are two different server connections in PI environments.

PI Data Archive → used for PI tags
Asset Framework (AF) → used for Elements, Attributes, Analyses

These are not the same object.

PI tags require a PI server connection ($pi), not an AF server object ($af).

After connecting to the PI Data Archive, verify the session with:

$pi.ConnectionInfo.IsConnected

You can also inspect basic server details with:

$pi.Name
$pi.ServerVersion

After running:

$pi = Connect-PI -ServerName "PI-SERVER"

$pi becomes an AFSDK PIServer object.

This object exposes server-level properties and methods used to interact with the PI Data Archive.

The $pi object provides access to:

• Connection information
• Server name
• Server version
• Server time zone
• PI Point search capabilities
• Methods to read snapshot values
• Methods to read recorded values
• Server-level configuration and metadata

$pi.ConnectionInfo.IsConnected
$pi.Name
$pi.ServerVersion

# Searching for a PI tag:
$pt = [OSIsoft.AF.PI.PIPoint]::FindPIPoint($pi, "sinusoid")

This repository was created as a personal learning project while working through the AVEVA PI System Developer learning path.

The goal is to better understand PowerShell scripting patterns for interacting with the AVEVA / OSIsoft PI System using the AFSDK API, including PI Data Archive connections, Asset Framework concepts, and common automation workflows used in industrial environments.

All examples use generic server names and publicly documented APIs.
The repository contains only personal learning material and does not include proprietary systems, data, or internal company information.

MIT License