AFSecurity.AddUser Method (PISystem, String, IList(AFSecurity), AFSecurityRights, AFSecurityRights, AFSecurityOperation, Boolean)

public static void AddUser(
	PISystem system,
	string accountName,
	IList<AFSecurity> items,
	AFSecurityRights accessRights = AFSecurityRights.None,
	AFSecurityRights denyRights = AFSecurityRights.None,
	AFSecurityOperation operation = AFSecurityOperation.Merge,
	bool applyToChildren = false
)

Public Shared Sub AddUser ( 
	system As PISystem,
	accountName As String,
	items As IList(Of AFSecurity),
	Optional accessRights As AFSecurityRights = AFSecurityRights.None,
	Optional denyRights As AFSecurityRights = AFSecurityRights.None,
	Optional operation As AFSecurityOperation = AFSecurityOperation.Merge,
	Optional applyToChildren As Boolean = false
)

Dim system As PISystem
Dim accountName As String
Dim items As IList(Of AFSecurity)
Dim accessRights As AFSecurityRights
Dim denyRights As AFSecurityRights
Dim operation As AFSecurityOperation
Dim applyToChildren As Boolean

AFSecurity.AddUser(system, accountName, 
	items, accessRights, denyRights, 
	operation, applyToChildren)

public:
static void AddUser(
	PISystem^ system, 
	String^ accountName, 
	IList<AFSecurity^>^ items, 
	AFSecurityRights accessRights = AFSecurityRights::None, 
	AFSecurityRights denyRights = AFSecurityRights::None, 
	AFSecurityOperation operation = AFSecurityOperation::Merge, 
	bool applyToChildren = false
)

static member AddUser : 
        system : PISystem * 
        accountName : string * 
        items : IList<AFSecurity> * 
        ?accessRights : AFSecurityRights * 
        ?denyRights : AFSecurityRights * 
        ?operation : AFSecurityOperation * 
        ?applyToChildren : bool 
(* Defaults:
        let _accessRights = defaultArg accessRights AFSecurityRights.None
        let _denyRights = defaultArg denyRights AFSecurityRights.None
        let _operation = defaultArg operation AFSecurityOperation.Merge
        let _applyToChildren = defaultArg applyToChildren false
*)
-> unit 

Parameters

system

Type: OSIsoft.AFPISystem
The PISystem containing the objects to be modified.

accountName

Type: SystemString
The account name of the user to be added to the objects.

items

Type: System.Collections.GenericIListAFSecurity
The list of AFSecurity objects to have the security rights modified for the user account.

accessRights (Optional)

Type: OSIsoft.AFAFSecurityRights
The access security rights for the accountName to be added to the objects. Specify None to not specify any access security rights to be added.

denyRights (Optional)

Type: OSIsoft.AFAFSecurityRights
The deny security rights for the accountName to be added to the objects. Specify None to not specify any deny security rights to be added.

operation (Optional)

Type: OSIsoft.AFAFSecurityOperation
The security operation which defines the behavior when adding security rights to an object that the user already has security rights specified.

applyToChildren (Optional)

Type: SystemBoolean

This parameter only has an effect if the associated object is an AFElement or AFEventFrame that has been added to a collection and saved to the server. For all other objects or if this parameter is , then the new access permissions are only applied to the associated object.

If and the associated object is an AFElement or AFEventFrame that has been added to a collection, then the access permissions for any parent or child objects might also change. The behavior depends on the reference type:

• For weak reference types, access permissions are never inherited. So, if you change the access permissions for the parent object, the permissions for the child object are not affected. Similarly, if you change the access permissions for the child object, the permissions for the parent object are not affected.
• For parent-child reference types, child permissions change when you change the permissions on the primary parent permissions. Parent permissions do not change when you change child permissions. Child elements that have a parent-child reference to the parent element, but are owned by a different element, are not in the primary path and will not have their permissions modified.

If the AFElement or AFEventFrame is a new object that has not been saved to the server, then it will be automatically saved so that the server can apply the security changes to the children.

Notes to Callers

For composition reference types, access permissions for child and parent are always the same, therefore the value of this parameter is ignored. So, if you change the access permissions for the child, the parent access permissions are automatically changed to match the child permissions. Similarly, if you change the access permissions for the parent, the child access permissions are automatically changed to match the parent permissions. These changes cascade down (and up) through the hierarchy.

This method will add the access and/or deny security rights for the user account to the specified objects in the PI AF Server associated with the PISystem. See the documentation for AFSecurityOperation for a description of the behavior of calling this method on existing security rights for an object.

Notes to Callers
For PI AF Server 2.7 or later you can call the AddIdentity Overload method to set the security access control with the new security identities which is supported by newer servers. You can use the PISystem.Supports method to check if the server supports SecurityIdentity. This method is not supported on a server before PI AF Server 2.6 if the applyToChildren parameter is .

AFSDK

Reference