SetPIUser Class
- Last UpdatedDec 15, 2025
- 3 minute read
Edits an existing PI User on a PI Data Archive
The Set-PIUser cmdlet edits an existing PI User 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
InternalCommand
Cmdlet
PSCmdlet
OSIsoft.PowerShellOSICmdletBase
OSIsoft.PowerShellSetPIUser
Namespace: OSIsoft.PowerShell
Assembly: OSIsoft.PowerShell (in OSIsoft.PowerShell.dll) Version: 2.2.3.0 (2.2.3.952)
Syntax
[CmdletAttribute("Set", "PIUser", SupportsShouldProcess = true)] public class SetPIUser : OSICmdletBase
<CmdletAttribute("Set", "PIUser", SupportsShouldProcess := true)> Public Class SetPIUser Inherits OSICmdletBase Dim instance As SetPIUser
[CmdletAttribute(L"Set", L"PIUser", SupportsShouldProcess = true)] public ref class SetPIUser : public OSICmdletBase
[<CmdletAttribute("Set", "PIUser", SupportsShouldProcess = true)>] type SetPIUser = class inherit OSICmdletBase end
The SetPIUser type exposes the following members.
Constructors
| Name | Description | |
|---|---|---|
 | SetPIUser |
Properties
| Name | Description | |
|---|---|---|
 | Connection | Connection to a PI Data Archive for which to edit the PI User |
| Description | Description to set for the PI User |
| Name | Name of the PI User to edit |
| PIGroups | PI Groups to set for the PI User |
Examples
Set-PIUser -Name "John Doe" -Description "Lead Floor Engineer" -PIGroups "EngineerLeadsGroup","PIReadersGroup","PIEngineersGroup" -Connection $con
Where:
$con = Connect-PIDataArchive -PIDataArchiveMachineName "PISRV1"
This example edits an existing PI User "John Doe" on the "PISRV1" PI Data Archive with an updated description and is assigned to three PI Groups.