PI Powershell

AddPIUserToPIGroup Class

Save PDF

TABLE OF CONTENTS

AddPIUserToPIGroup Class

Save PDF

Last UpdatedDec 15, 2025
3 minute read

Add an existing PI User to PI Groups on a PI Data Archive

The Add-PIUserToPIGroups cmdlet adds an existing PI User to the specified PI Groups on a PI Data Archive

The connection parameter specifies which connection to a PI Data Archive to use.

NOTE: PI Users and PI Groups have been replaced by PI Identities. PI Identities with PI Mappings (WIS) and PI Trusts should be used to configure PI Data Archive security. See KB00833 for more information.

Inheritance Hierarchy

SystemObject
  InternalCommand
    Cmdlet
      PSCmdlet
        OSIsoft.PowerShellOSICmdletBase
          OSIsoft.PowerShellAddPIUserToPIGroup

Namespace: OSIsoft.PowerShell
Assembly: OSIsoft.PowerShell (in OSIsoft.PowerShell.dll) Version: 2.2.3.0 (2.2.3.952)

Syntax

[CmdletAttribute("Add", "PIUserToPIGroup", SupportsShouldProcess = true)]
public class AddPIUserToPIGroup : OSICmdletBase

<CmdletAttribute("Add", "PIUserToPIGroup", SupportsShouldProcess := true)>
Public Class AddPIUserToPIGroup
	Inherits OSICmdletBase

Dim instance As AddPIUserToPIGroup

[CmdletAttribute(L"Add", L"PIUserToPIGroup", SupportsShouldProcess = true)]
public ref class AddPIUserToPIGroup : public OSICmdletBase

[<CmdletAttribute("Add", "PIUserToPIGroup", SupportsShouldProcess = true)>]
type AddPIUserToPIGroup =  
    class
        inherit OSICmdletBase
    end

The AddPIUserToPIGroup type exposes the following members.

Constructors

	Name	Description
	AddPIUserToPIGroup

Properties

	Name	Description
	Connection	Connection to a PI Data Archive for which to add the PI User to the PI Groups
	Name	Name of the PI User to add to PI Groups
	PIGroups	PI Groups for which to add the PI User

Examples

Add-PIUserToPIGroups -Name "John Doe" -PIGroups "PIEngineersGroup","PIReadersGroup" -Connection $con

Where:

$con = Connect-PIDataArchive -PIDataArchiveMachineName "PISRV1"

This example adds an existing PI User "John Doe" to two PI Groups "PIEngineersGroup" and "PIReadersGroup".

PI Powershell