加-NCache用户或组

此 PowerShell cmdlet 用于添加用户、组或 gMSA 缓存用户（非管理员用户适用）来的 NCache 安全配置。此配置可应用于： NCache 该 cmdlet 支持基于角色的访问控制，允许用户或组被分配管理员权限（用于完整的集群管理）或缓存级权限（用于执行特定于缓存的操作）。该 cmdlet 需要服务器、访问级别、用户或组名、完整可分辨名称 (DN)、域控制器以及管理员凭据等参数。它会根据域控制器验证提供的身份信息，应用必要的安全元数据，并将用户或组添加到配置中。此外，该 cmdlet 还可以选择在成功执行后自动启用安全性，这使得它对于安全的生产部署至关重要。

重要提示

请注意，您需要事先启用节点安全才能成功执行此命令。

Add-NCacheUserOrGroup -Server -AccessLevel `
                      [-CacheName] -UserOrGroupName `
                      -UserOrGroupDN [-DomainController] `
                      [-DomainControllerPort] [-SecondaryDomainController] `
                      [-SecondaryDomainControllerPort] -NodeAdminCredentials

例子

  • 此命令将用户 David Watson 添加为 NCache 服务器管理员，IP 地址为 20.200.20.11。
$nodeAdmin = Get-Credential `
Add-NCacheUserOrGroup -Server 20.200.20.11 `
-AccessLevel Admin  -NodeAdminCredentials $nodeAdmin `
-UserOrGroupName david_watson `
-UserOrGroupDN "CN=David Watson,OU=engineers,DC=example,DC=com" `
-DomainController domain_controller
  • 此命令将用户 David Watson 添加为托管在 IP 地址为 20.200.20.11 的服务器上的“demoCache”缓存的缓存用户。
 $nodeAdmin = Get-Credential `
 Add-NCacheUserOrGroup -Server 20.200.20.11 `
-AccessLevel Cache -CacheName demoCache `
-NodeAdminCredentials $nodeAdmin -UserOrGroupName david_watson `
-UserOrGroupDN "CN=David Watson,OU=engineers,DC=example,DC=com" `
-DomainController domain_controller
  • 添加-NCacheUserOrGroup cmdlet 也支持 gMSA 帐户（如果提供的用户名是 gMSA）。 NCache 查询 LDAP 以检测帐户类型并进行相应记录。以下命令添加 gMSA 缓存用户 'user1gmsa$' 在指定位置 NCache 服务器。
$nodeAdmin = Get-Credential `
Add-NCacheUserOrGroup -Server 20.200.20.11 `
-AccessLevel Cache -CacheName demoCache `
-NodeAdminCredentials $nodeAdmin -UserOrGroupName user1gmsa$ `
-UserOrGroupDN "CN=user1gmsa,CN=Managed Service Accounts,DC=example,DC=com" `
-DomainController domain_controller
  • 此命令添加一个名为“Dev”的组作为 NCache 服务器 IP 地址为 20.200.20.11 的管理员组。
$nodeAdmin = Get-Credential `
Add-NCacheUserOrGroup -Server 20.200.20.11 `
-AccessLevel Admin  -NodeAdminCredentials $nodeAdmin `
-UserOrGroupName Dev `
-UserOrGroupDN "CN=Dev,OU=engineers,DC=example,DC=com" `
-DomainController domain_controller

物业

注意：

名称上带有星号 (*) 的参数为必填参数，其余为可选参数。

参数 数据类型 描述
-Server* <string> 指定 IP 地址 NCache 正在添加用户或组的服务器。
-UserOrGroupName* <string> 指定要添加的用户或组的名称。
-UserOrGroupDN* <string> 指定要添加的用户或组的可分辨名称 (DN)。此 DN 唯一地标识 LDAP 目录中的用户或组。
-DomainControllerPort <int> 指定域控制器正在监听的端口。默认端口为 389.
-DomainController <string> 指定用于验证用户或组身份的域控制器的 IP 地址或主机名。
-SecondaryDomainController <string> 指定用于验证用户或组身份的辅助域控制器的 IP 地址或主机名。
-SecondaryDomainControllerPort <int> 指定辅助域控制器监听的端口。默认端口为 389.
-AccessLevel* <string> 指定要添加的用户或组的访问级别。有效值为： Admin 为 NCache 管理员和 Cache 针对特定缓存用户。
-CacheName <string> 指定要添加用户或组的缓存名称。此参数为： 必须 ，尤其是 -AccessLevel 被设置为 Cache.
-NodeAdminCredentials* <pscredential> 指定具有足够权限的用户凭据，以便将用户或组添加到 NCache.