Add-NodeSecurity
Note
This feature is only available in NCache Enterprise Edition.
Add-NodeSecurity cmdlet configures server node level security so that
NCache tasks can be performed.
Add-NodeSecurity [-AddUser] -AdminUserID -AdminPassword [-DeleteUser] [-RemoveUser] [-EnableSecurity] [-DisableSecurity] -PrimaryLdap [-PrimaryLdapPort] [-SecondaryLdap] [-SecondayLdapPort] [-NewUser] [-NewUserDN] [-NewUserPassword] -NodeName [-Port] [-NoLogo] [-WriteToServiceConfig]
These properties are explained in detail in the Properties section.
Examples
- The following command adds new user david_watson to security list on node 20.200.20.11 which has administrator john_smith and primary controller domain is yourprimarydomain. This writes the credentials to security.ncconf.
Add-NodeSecurity -AddUser -AdminUserID john_smith -AdminPassword mypassword -NewUser david_watson -NewUserPassword userpassword -NewUserDN "CN=David Watson,OU=admin,DC=yourdomain,DC=org " -PrimaryLdap yourprimarydomain -PrimaryLdapPort 389 -NodeName 20.200.20.11
- The following command adds a new user david_watson to security list on node 20.200.20.11 where admin id is john_smith, primary LDAP controller in yourprimarydomain and secondary (optional) LDAP controller is yoursecondarydomain.
Add-NodeSecurity -AddUser -AdminUserID john_smith -AdminPassword mypassword -NewUser david_watson -NewUserPassword userpassword -NewUserDN "CN=David Watson,OU=admin,DC=yourdomain,DC=org " -PrimaryLdap yourprimarydomain -PrimaryLdapPort 389 -SecondaryLdap yoursecondarydomain -SecondaryLdapPort 389 -NodeName 20.200.20.11
- The following command deletes existing user david_watson from the security list on node 20.200.20.11 which has administrator john_smith and yourprimarydomain as the primary LDAP controller.
Add-NodeSecurity -RemoveUser -AdminUserID john_smith -AdminPassword mypassword -DeleteUser david_watson -PrimaryLdap yourprimarydomain -PrimaryLdapPort 389 -NodeName 20.200.20.11
- The following command enables security on node 20.200.20.11 which has administrator john_smith with primary LDAP domain as yourprimarydomain and secondary (optional) LDAP domain as yoursecondarydomain.
Add-NodeSecurity -EnableSecurity -AdminUserID john_smith -AdminPassword mypassword -PrimaryLdap yourprimarydomain -PrimaryLdapPort 389 -SecondaryLdap yoursecondarydomain -SecondaryLdapPort 389 -NodeName 20.200.20.11
- The following command disables security on node 20.200.20.11 which has administrator john_smith where the primary and secondary LDAP controllers are yourprimarydomain and yoursecondarydomain respectively.
Add-NodeSecurity -DisableSecurity -AdminUserID john_smith -AdminPassword mypassword -PrimaryLdap yourprimarydomain -PrimaryLdapPort 389 -SecondaryLdap yoursecondarydomain -SecondaryLdapPort 389 -NodeName 20.200.20.11
Properties
Note: The parameters with an asterisk (*) with their names are the required parameters and the rest are optional.
| Parameters | Data Types | Description | Default Value |
|---|---|---|---|
-AddUser |
<SwitchParameter> |
Specifies that the cmdlet is being used for adding a user to NCache node administrators. | - |
-RemoveUser |
<SwitchParameter> |
Specifies that the cmdlet is being used for removing a user from NCache node administrators. | - |
-EnableSecurity |
<SwitchParameter> |
Specifies that the cmdlet is being used for enabling security on a specific node. | - |
-DisableSecurity |
<SwitchParameter> |
Specifies that the cmdlet is being used for disabling security on a specific node. | - |
-NewUser |
<String> |
Specifies the new user information to add. | - |
-NewUserDN |
<String> |
Specifies the new user's distinguished name. | - |
-NewUserPassword |
<String> |
Password of new user. | - |
-DeleteUser |
<SwitchParameter> |
Specifies the existing user which is now being deleted or removed from NCache node administrators. | - |
-NodeName* |
<String> |
Specifies the target node. | - |
-AdminUserID* |
<String> |
Specifies the NCache administrator name. | - |
-AdminPassword* |
<String> |
Specifies the NCache administrator password. | - |
-PrimaryLdap* |
<String> |
Specifies the primary domain controller. | - |
-PrimaryLdapPort |
<Integer> |
Specifies the port on which primary domain controller is running. | 389 |
-SecondaryLdap |
<String> |
Specifies the secondary domain controller. Used for credential authentication if the primary domain controller is unavailable. | - |
-SecondaryLdapPort |
<Integer> |
Specifies the secondary port on which primary domain controller is running. | 389 |
-Port |
<Integer> |
Specifies the port on which NCache service is running. | 8250 |
-WriteToServiceConfig |
<SwitchParameter> |
Specifies whether to write to service configurations. If specified, the tool will write user name and password (encrypted) in NCache.Service.exe.config file for caches that require security credentials during auto-start. | - |
-NoLogo |
<SwitchParameter> |
Suppresses display of the logo banner. | - |