blob: 1591573a769a031b3438f875edd69ed61b0b24c0 [file] [log] [blame]
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)]