PIIdentityMappings.Add Method (String, String, String, PIIdentityMappingType)

public PIIdentityMapping Add(
	string name,
	string principalName,
	string identity,
	PIIdentityMappingType mappingType
)

// Get the PIIdentityMappings from the PIServer on the local computer
PISystems myPISystems = new PISystems();
PISystem myPISystem = myPISystems.DefaultPISystem;
PIServer myPIServer = PIServer.FindPIServer(myPISystem, piServerName);

// Add a mapping, if it does not yet exist.
string newMapName = @"Windows\S-1-5-32-544";
string mapAIMServerAdministrators = @"Windows\S-1-5-32-544";
string identity = "piadmins";

PIIdentityMappings mappings = myPIServer.IdentityMappings;
PIIdentityMapping newMap;
if (!mappings.Contains(newMapName))
{
    // Note that adding or editing a mapping requires 'CheckIn' in order to commit it to the PI Data Archive.
    newMap = mappings.Add(newMapName, mapAIMServerAdministrators, identity, PIIdentityMappingType.Role);
    newMap.CheckIn();
}
else
    newMap = mappings[newMapName];

Console.WriteLine(newMap.Name);
Console.WriteLine("  ID: {0}", newMap.ID);
Console.WriteLine("  Description: {0}", newMap.Description);
Console.WriteLine("  Principal: {0}", newMap.Principal);
Console.WriteLine("  PrincipalName: {0}", newMap.PrincipalName);
Console.WriteLine("  Identity: {0}", newMap.Identity);
Console.WriteLine("  IdentityMappingType: {0}", newMap.IdentityMappingType);
Console.WriteLine("  IsEnabled: {0}", newMap.IsEnabled);
Console.WriteLine();

myPIServer.Connect(TestAccountAccessToken);

// Create a ClientCredential Mapping
newMap = null;
if (!mappings.Contains(TestClientId))
{
    // Note that adding or editing a mapping requires 'CheckIn' in order to commit it to the PI Data Archive.
    newMap = mappings.Add(TestClientId, TestClientId, identity, PIIdentityMappingType.ClientCredential);
    newMap.CheckIn();
}
else
    newMap = mappings[TestClientId];