Plug-in registration

You can register PI AF plug-ins and other support assemblies with the RegPlugIn and RegPlugIn64 command-line utilities. For a list of parameters, see RegPlugIn parameters.

Note: The AF SDK .NET 3.5 is no longer shipped beginning with the release of PI AF 2018 SP3 Patch 2. Customers should migrate to the AF SDK .NET 4 and update their plugins accordingly.

The Plug-In registration utilities are located in the \PIPC\AF folders for their corresponding Program Files directories:

\Program Files\PIPC\AF\RegPlugIn64.exe
\Program Files (x86)\PIPC\AF\RegPlugIn.exe

Examples

In the following examples, MyPISystem is the PI AF server where the Plug-In is to be registered, MyPlugIn.dll is the name of the Plug-In assembly, and Support.dll is the name of a support assembly for the Plug-In.

• .NET 3.5 Only Plug-In Targeting Any CPU

  The simplest to register, this implementation works on any operating system architecture and both versions of the .NET Framework. It cannot use new features that are specific to the .NET 4 version of AF SDK.

  RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll

• .NET 4 Only Plug-In Targeting Any CPU

  This implementation works on any operating system architecture and the .NET 4 Framework. It does not work with the .NET 3.5 version of the AF SDK.

  RegPlugIn /PISystem:MyPISystem PlugIns\4.0\MyPlugIn.dll

• .NET 3.5 and .NET 4 Plug-In Targeting Any CPU

  This Plug-In has two implementations. One targets the .NET 3.5 Framework and works with the .NET 3.5 version of AF SDK, and the other targets the .NET 4 Framework and works with the .NET 4 version of AF SDK. Both implementations are registered with the following command:

  RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll PlugIns\4.0\MyPlugIn.dll

• .NET 3.5 Only Plug-In Targeting 32- and 64-Bit Platforms

  This Plug-In has two implementations for the .NET 3.5 Framework. One implementation targets 32-bit operating systems and the other one targets 64-bit operating systems. With both implementations registered, the Plug-In works on any operating system architecture and both versions of the .NET Framework, but cannot use the new features that are specific to the .NET 4 version of AF SDK.

  RegPlugIn /PISystem:MyPISystem PlugIns\x86\MyPlugIn.dll

  RegPlugIn64 /PISystem:MyPISystem PlugIns\x64\MyPlugIn.dll

• .NET 3.5 and .NET 4 Plug-In Targeting 32- and 64-Bit Platforms

  This Plug-In has four implementations. Two implementations are for the .NET 3.5 Framework, one for 32- and one for 64-bit platforms. The other two implementations are for the .NET 4, one for 32- and one for 64-bit platforms. With all implementations registered, it works on any operating system architecture and both versions of the .NET Framework.

  RegPlugIn /PISystem:MyPISystem PlugIns\x86\MyPlugIn.dll PlugIns\4.0\x86\MyPlugIn.dll

  RegPlugIn64 /PISystem:MyPISystem PlugIns\x64\MyPlugIn.dll PlugIns\4.0\x64\MyPlugIn.dll

• .NET 3.5 Only Plug-In and Support Assembly Targeting Any CPU

  This implementation, with its support assembly, works on any operating system architecture and both versions of the .NET Framework. It cannot use the new features that are specific to the .NET 4 version of AF SDK.

  RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll PlugIns\Support.dll

• .NET 3.5 and .NET 4 Plug-In and Support Assembly Targeting Any CPU

  This Plug-In has two implementations with two implementations of its support assembly. One targets the .NET 3.5 Framework and works with the .NET 3.5 version of AF SDK. The other targets the .NET 4 Framework and works with the .NET 4 version of AF SDK. Both implementations along with their support assemblies are registered with the following command.

  RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll PlugIns\Support.dll PlugIns\4.0\MyPlugIn.dll PlugIns\4.0\Support.dll