type=page
status=published
title=update-connector-security-map
next=update-connector-work-security-map.html
prev=unset-web-env-entry.html
~~~~~~

= update-connector-security-map

[[update-connector-security-map-1]][[GSRFM00252]][[update-connector-security-map]]

== update-connector-security-map

Modifies a security map for the specified connector connection pool

[[sthref2258]]

=== Synopsis

[source]
----
asadmin [asadmin-options] update-connector-security-map [--help]
--poolname connector_connection_pool_name
[--addprincipals principal_name1[,principal_name2]*]
[--addusergroups user_group1[,user_group2]*]
[--removeprincipals principal_name1[,principal_name2]*]
[--removeusergroups user_group1[,user_group2]*]
[--mappedusername username]
mapname
----

[[sthref2259]]

=== Description

The `update-connector-security-map` subcommand modifies a security map
for the specified connector connection pool.

For this subcommand to succeed, you must have first created a connector
connection pool using the `create-connector-connection-pool` subcommand.

This subcommand is supported in remote mode only.

[[sthref2260]]

=== Options

asadmin-options::
  Options for the `asadmin` utility. For information about these
  options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page.
`--help`::
`-?`::
  Displays the help text for the subcommand.
`--poolname`::
  Specifies the name of the connector connection pool to which the
  security map that is to be updated belongs.
`--addprincipals`::
  Specifies a comma-separated list of EIS-specific principals to be
  added. Use either the `--addprincipals` or `--addusergroups` options,
  but not both in the same command.
`--addusergroups`::
  Specifies a comma-separated list of EIS user groups to be added. Use
  either the `--addprincipals` or `--addusergroups` options, but not
  both in the same command.
`--removeprincipals`::
  Specifies a comma-separated list of EIS-specific principals to be
  removed.
`--removeusergroups`::
  Specifies a comma-separated list of EIS user groups to be removed.
`--mappedusername`::
  Specifies the EIS username.

[[sthref2261]]

=== Operands

mapname::
  The name of the security map to be updated.

[[sthref2262]]

=== Examples

[[GSRFM785]][[sthref2263]]

==== Example 1   Updating a Connector Security Map

This example adds principals to the existing security map named `securityMap1`.

[source]
----
asadmin> update-connector-security-map --poolname connector-pool1
--addprincipals principal1,principal2 securityMap1
Command update-connector-security-map executed successfully
----

[[sthref2264]]

=== Exit Status

0::
  subcommand executed successfully
1::
  error in executing the subcommand

[[sthref2265]]

=== See Also

link:asadmin.html#asadmin-1m[`asadmin`(1M)]

link:create-connector-security-map.html#create-connector-security-map-1[`create-connector-security-map`(1)],
link:delete-connector-security-map.html#delete-connector-security-map-1[`delete-connector-security-map`(1)],
link:list-connector-security-maps.html#list-connector-security-maps-1[`list-connector-security-maps`(1)]