PowerShell JEA受限管理如何划分命令权限?角色能力怎么验证
PowerShell JEA(Just Enough Administration)通过受限远程会话,把操作人员能调用的命令、函数和参数限定在预设范围内。首次部署时,应先确定角色能执行哪些具体操作,再配置 WinRM 认证与网络边界、运行身份、审计记录,最后用授权账号验证允许和拒绝的操作;不要把 JEA 简单等同于“给管理员开一个远程 PowerShell”。
以下示例以受域管理的 Windows Server 为目标,创建一个仅能查看并重启指定服务的 JEA 端点。示例中的域名、组名和服务名均需替换为实际值。若运行身份需要重启服务,目标服务器上还必须预先为该身份配置对应服务的启动、停止权限;不应为了方便直接授予本地管理员权限。
准备条件
实施前确认目标服务器和操作账号符合以下条件:
- 目标服务器已安装并维护受支持的 Windows PowerShell 版本。JEA 可用于 Windows PowerShell 5.1;PowerShell 7 的远程端点注册和配置方式可能不同,本例按 Windows PowerShell 5.1 编写。
- 有权限在目标服务器上启用或检查 WinRM、创建本地目录和组、注册 PowerShell 会话端点。注册端点需要以提升权限的 PowerShell 运行。
- 已准备好用于角色授权的域安全组,例如
CONTOSO\JEA_Service_Operators。该组应只包含确实需要执行这些操作的账号。 - 已确认示例服务
A5AppSvc的实际服务名。Get-Service显示的Name才是服务名,不一定与服务管理器中显示的名称相同。 - 已规划运行身份的权限。示例使用虚拟账号并将其加入专用本地组
JEA_Service_Operators,而不是默认授予本地管理员权限。专用组只应获得目标服务所需权限。 - 已确认 WinRM 的监听方式、允许的客户端网段和认证方案。域内优先使用 Kerberos;跨不可信网络连接应使用经过正确配置的 HTTPS 监听器。不要通过开放更大网段或启用明文 Basic 认证来绕过连接问题。
先在目标服务器查看系统、PowerShell 和 WinRM 状态:
$PSVersionTable.PSVersion
Get-Service WinRM
winrm enumerate winrm/config/listener
预期能确认 PowerShell 版本,WinRM 服务状态,以及当前监听器使用的传输方式和端口。默认 WinRM 端口通常是 HTTP 的 TCP 5985 和 HTTPS 的 TCP 5986;实际应以服务器监听器及防火墙规则为准。若 WinRM 未运行或未配置监听器,先按组织的远程管理标准完成配置,再继续创建端点。
JEA端点承载着远程管理会话与受限操作,A5idc数据提供香港、美国、日本等地区的物理服务器,可为企业业务后台、接口服务和多任务运行提供不同的处理器、内存、存储及网络线路组合。香港和美国的部分方案配有NVMe存储,其他地区也有相应的服务器配置,便于为远程运维与业务服务部署匹配计算和网络资源。
第一步:明确角色允许的操作
JEA 权限边界由角色能力文件和会话配置共同决定。角色能力文件定义该角色可见的命令或函数,会话配置则把角色映射到用户或组,并指定运行身份等会话级属性。

本例只开放两个固定用途的函数:
| 能力 | 允许的操作 | 有意不开放的能力 |
|---|---|---|
| 查看服务状态 | 查看 A5AppSvc 的名称和状态 | 查询任意服务、读取其他系统信息 |
| 重启指定服务 | 重启 A5AppSvc 并返回状态 | 传入任意服务名、修改启动类型、执行任意命令 |
将服务名固定在函数定义中,比直接开放完整的 Restart-Service 更容易限制操作范围。若实际需求涉及多个服务,应逐个审核并明确允许列表,不要把服务名参数开放成任意字符串。
创建角色能力目录和会话配置目录:
$RoleModuleRoot = Join-Path $env:ProgramFiles 'WindowsPowerShell\Modules\A5.JEA.ServiceOps'
$RoleCapabilityDir = Join-Path $RoleModuleRoot 'RoleCapabilities'
$ConfigDir = Join-Path $env:ProgramData 'A5\JEA'
New-Item -ItemType Directory -Path $RoleCapabilityDir -Force
New-Item -ItemType Directory -Path $ConfigDir -Force
预期会创建类似以下路径:
C:\Program Files\WindowsPowerShell\Modules\A5.JEA.ServiceOps\RoleCapabilities
C:\ProgramData\A5\JEA
对这些目录设置受控的写入权限。一般只允许管理员维护角色定义,普通操作人员不应能修改 .psrc 或 .pssc 文件。角色配置若可被低权限账号改写,权限边界就可能被绕过。
创建角色能力文件:
$RoleFile = Join-Path $RoleCapabilityDir 'ServiceOperator.psrc'
@'
@{
GUID = 'd07dbbe6-80e9-4f52-82d7-2c9b64d1d4d2'
Author = 'IT Operations'
Description = 'View and restart the approved application service.'
ModulesToImport = @()
VisibleCmdlets = @()
FunctionDefinitions = @(
@{
Name = 'Get-AppServiceStatus'
ScriptBlock = {
Get-Service -Name 'A5AppSvc' |
Select-Object Name, Status
}
},
@{
Name = 'Restart-AppService'
ScriptBlock = {
Restart-Service -Name 'A5AppSvc' -ErrorAction Stop
Get-Service -Name 'A5AppSvc' |
Select-Object Name, Status
}
}
)
}
'@ | Set-Content -Path $RoleFile -Encoding UTF8
这里没有把 Get-Service 或 Restart-Service 作为可直接调用的命令暴露给角色,而是通过固定服务名的函数提供有限能力。函数仍以会话运行身份执行;因此,运行身份是否有权重启该服务,决定了第二个函数能否成功。
验证角色文件
检查文件是否存在,并让 PowerShell 解析其数据文件内容:
Test-Path $RoleFile
Import-PowerShellDataFile -Path $RoleFile
预期 Test-Path 返回 True,数据文件可以被解析。如果解析失败,先修正引号、括号或逗号,再注册端点。不要在解析失败时继续注册,以免把文件格式问题与权限问题混在一起排查。
然后创建 PowerShell 模块清单,使角色能力文件能够通过模块名被引用:
$ManifestPath = Join-Path $RoleModuleRoot 'A5.JEA.ServiceOps.psd1'
New-ModuleManifest `
-Path $ManifestPath `
-RootModule '' `
-ModuleVersion '1.0.0' `
-Guid 'eec8be29-3fec-48bd-b51f-11a62660f55e' `
-Author 'IT Operations' `
-Description 'JEA role capabilities for approved service operations.'
验证模块可以被发现:
Test-ModuleManifest -Path $ManifestPath
Get-Module -ListAvailable A5.JEA.ServiceOps
若模块未被发现,确认文件位于系统模块目录下,目录名与模块名一致,并检查模块清单是否有效。
第二步:确认运行身份的最小权限
创建专用本地组,再为其配置目标服务所需权限。以下命令只创建组,不会自动授予服务权限:
$LocalGroup = 'JEA_Service_Operators'
if (-not (Get-LocalGroup -Name $LocalGroup -ErrorAction SilentlyContinue)) {
New-LocalGroup -Name $LocalGroup -Description 'Narrow permissions for JEA service operations'
}
Get-LocalGroup -Name $LocalGroup
应由具备相应权限的管理员单独评估并配置该组对目标服务的服务控制权限。通常只需满足查询状态以及启动、停止服务等需要;不应授予修改服务配置、替换服务程序或管理服务器的权限。服务权限调整会改变安全边界,实施前应记录现有服务安全描述符,并依照组织的变更流程备份和审核。不要直接套用来源不明的 sc.exe sdset 字符串。
验证运行身份前提
先记录当前服务名、状态和服务账户,确认目标没有选错:
Get-CimInstance Win32_Service -Filter "Name='A5AppSvc'" |
Select-Object Name, DisplayName, State, StartName
确认目标服务存在,且准备调整的权限仅覆盖该服务。虚拟账号在会话中使用目标服务器上的身份执行操作;当配置了 RunAsVirtualAccountGroups 时,应确认其实际组成员关系符合预期。不要假定虚拟账号自动拥有所需服务权限,也不要因服务操作被拒绝就把它加入本地 Administrators 组。
如果服务器上已有同名本地组,确认该组成员和现有用途后再复用;不要未经检查就把现有业务组当作 JEA 专用组。
第三步:创建受限会话配置
会话配置将域组映射到角色能力,并指定虚拟账号所属的专用本地组。以下示例面向 Windows PowerShell 5.1:
$PsscPath = Join-Path $ConfigDir 'JEA-ServiceOps.pssc'
New-PSSessionConfigurationFile `
-Path $PsscPath `
-SessionType RestrictedRemoteServer `
-RoleDefinitions @{
'CONTOSO\JEA_Service_Operators' = @{
RoleCapabilities = 'ServiceOperator'
}
} `
-RunAsVirtualAccount `
-RunAsVirtualAccountGroups 'JEA_Service_Operators' `
-TranscriptDirectory (Join-Path $ConfigDir 'Transcripts')
把 CONTOSO\JEA_Service_Operators 替换为实际域组。RestrictedRemoteServer 限制会话可用的基础功能;角色能力文件再提供获批的操作。TranscriptDirectory 指定会话转录目录,目录应只允许受信任的管理员和审计人员读取,并预先设置合适的存储容量、保留周期和备份策略。转录记录可能包含操作输入和输出,不应对全体用户开放。
检查并测试会话配置文件:
Test-Path $PsscPath
Test-PSSessionConfigurationFile -Path $PsscPath
预期配置文件存在,且测试命令报告配置有效。若测试失败,先检查角色名、角色组格式、模块路径和配置文件语法。修改配置后应重新测试,再进入注册步骤。
认证与网络边界检查
JEA 只限制 PowerShell 会话内的操作,不替代 WinRM 的认证、加密和网络访问控制。注册端点前核对以下事项:
- 域内管理尽量使用 Kerberos,并确认客户端通过域名连接目标服务器。使用 IP 地址连接时,Kerberos 可能无法按预期工作。
- 若通过不可信网络管理,使用有效证书配置 WinRM HTTPS 监听器,并核验客户端能验证证书名称、链和有效期。
- 不要启用未加密的远程会话,也不要在 HTTP 监听器上使用 Basic 认证。
- Windows 防火墙只允许受信任的管理网段访问实际使用的 WinRM 端口。不要为了测试而关闭整个防火墙或对所有来源开放管理端口。
查看监听器与防火墙规则:
winrm enumerate winrm/config/listener
Get-NetFirewallRule -DisplayGroup 'Windows Remote Management' |
Select-Object DisplayName, Enabled, Profile, Direction, Action
不同 Windows 版本和本地化系统的防火墙规则组名称可能不同。若命令未返回预期结果,应先查询现有规则名称和作用域,不要猜测名称后直接创建范围过宽的规则。完成网络配置变更前,记录原有监听器、防火墙规则和允许来源,以便回滚。
第四步:注册端点并检查注册结果
注册前确认没有同名端点,避免 -Force 覆盖未知配置:
Get-PSSessionConfiguration |
Where-Object Name -eq 'JEA-ServiceOps'
若没有结果,可以注册;若已有结果,先查明其用途并备份现有配置,再决定是否更新:
Register-PSSessionConfiguration `
-Name 'JEA-ServiceOps' `
-Path $PsscPath
注册完成后查看端点:
Get-PSSessionConfiguration -Name 'JEA-ServiceOps' |
Select-Object Name, Permission, ConfigFilePath
预期能够看到 JEA-ServiceOps 及其配置文件路径。注册失败时先查看报错和系统事件,不要立即使用 -Force 重试。确认文件路径、权限和端点是否已存在,再采取对应处理。
检查角色组对应的会话能力:
Get-PSSessionCapability `
-ConfigurationName 'JEA-ServiceOps' `
-Username 'CONTOSO\JEA_Service_Operators'
输出应包含定义的两个函数。若输出为空或角色解析失败,检查 RoleDefinitions 中的组名是否准确、客户端账号是否属于该组,以及角色能力模块是否位于 PowerShell 可发现的模块路径中。
第五步:用授权账号验证允许与拒绝的操作
使用角色组中的普通操作账号,从管理客户端连接指定端点。不要用服务器管理员账号替代授权账号验证,否则测试结果不能代表实际角色权限。
$Session = New-PSSession `
-ComputerName 'server01.contoso.com' `
-ConfigurationName 'JEA-ServiceOps' `
-Authentication Kerberos
Invoke-Command -Session $Session -ScriptBlock {
Get-Command
Get-AppServiceStatus
}
成功时,受限会话中应能看到允许的函数,并返回 A5AppSvc 的服务状态。具体输出由服务当前状态决定;示例输出仅用于说明格式:
Name Status
---- ------
A5AppSvc Running
接着验证重启功能:
Invoke-Command -Session $Session -ScriptBlock {
Restart-AppService
}
若运行身份拥有该服务所需权限,函数应完成重启并返回服务状态。重启可能中断依赖该服务的应用连接,应在维护窗口或已评估影响的时段测试。若返回“拒绝访问”,说明会话角色可能已暴露函数,但运行身份没有足够的服务控制权限;应检查服务权限和虚拟账号组,而不是直接扩大为服务器管理员权限。
然后验证越权操作确实受限:
Invoke-Command -Session $Session -ScriptBlock {
Get-Process
}
此命令应不可用或被拒绝。再尝试用任意服务名调用受限函数:
Invoke-Command -Session $Session -ScriptBlock {
Restart-AppService -Name 'Spooler'
}
此调用应失败,因为函数没有开放 Name 参数。若普通账号能执行未授权命令,或能修改角色文件,应立即暂停上线,检查实际连接的端点、角色组映射、角色文件 ACL 和会话配置;不要把“命令返回失败”作为唯一验收标准。

完成测试后关闭会话:
Remove-PSSession -Session $Session
异常处理:按影响范围由小到大检查
无法建立远程会话
先从管理客户端检查名称解析和目标端口连通性:
Test-NetConnection -ComputerName 'server01.contoso.com' -Port 5985
如果实际使用 HTTPS,则检查 5986。端口不通通常指向监听器、防火墙或网络路由问题,不代表 JEA 角色配置错误。端口可达但认证失败时,检查连接使用的主机名、客户端与服务器的域信任关系、Kerberos 状态和 HTTPS 证书。不要通过放宽到任意来源、启用明文认证或禁用防火墙来掩盖认证问题。
找不到角色能力或授权角色为空
确认端点注册使用的配置文件仍在预期位置,角色名与模块中的 .psrc 文件名匹配,并再次运行:
Get-Module -ListAvailable A5.JEA.ServiceOps
Import-PowerShellDataFile -Path $RoleFile
Get-PSSessionCapability -ConfigurationName 'JEA-ServiceOps' `
-Username 'CONTOSO\JEA_Service_Operators'
同时核对被测试账号是否确实属于授权组。组成员关系变更后,客户端可能需要重新登录以取得新的访问令牌。
函数可见但服务操作被拒绝
这通常是运行身份权限不足、目标服务名不正确,或服务控制访问被服务 ACL 拒绝。先在目标服务器核对服务是否存在和实际服务名,再由管理员审核虚拟账号的本地组配置与服务权限。不要为了消除错误而开放 Restart-Service 全部参数,或把虚拟账号加入管理员组。
转录文件未生成或无法写入
确认转录目录存在、端点运行身份能够按配置写入、磁盘空间充足,并检查目录 ACL 和事件日志。不要把目录改成所有用户可写。若短期内无法满足转录存储和访问控制要求,应先暂停上线,而不是关闭审计后继续运行。
结果检查与回滚
上线前至少确认以下项目:
- 权限边界:授权账号能执行规定的查看和重启函数;任意服务名、未授权 cmdlet 和服务器管理操作均不可用。
- 运行身份:虚拟账号仅属于必要的专用组;目标服务权限已单独审核,没有依赖本地管理员权限。
- 认证与端口:端点使用经确认的认证方式;WinRM 监听端口与实际用途一致,防火墙仅允许受信任的管理来源。
- 审计:转录目录存在、权限受控、能按组织策略保存和访问;同时确认相关 Windows 事件可供排查。
- 变更记录:保存原会话配置、服务权限和防火墙设置的备份,并记录端点名称、角色组、允许的函数和回滚负责人。
若需要撤销 JEA 端点,先通知操作人员停止使用该端点,再移除注册。此操作会终止通过该端点建立的管理入口;执行前确认没有依赖它的自动化任务:
Unregister-PSSessionConfiguration -Name 'JEA-ServiceOps' -Force
确认端点已移除:
Get-PSSessionConfiguration |
Where-Object Name -eq 'JEA-ServiceOps'
若曾调整防火墙或服务权限,应按变更前记录逐项恢复到原值,不要通过关闭 WinRM 或关闭整个防火墙回滚。确认没有其他端点或自动化流程依赖后,再按组织的数据保留要求处理角色文件、配置文件和转录记录;不要在需要保留审计证据时直接删除转录目录。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7004.html

