使用Ansible win_file模块删除Windows用户文件夹无报错未生效问题

两个配置的问题分别如下：

• 第一段配置无报错但未删除成功的核心原因
  1. 对force: yes参数的作用存在误解：win_file模块的force参数仅支持递归删除子项、跟随软链接删除目标、替换同名非目录文件，没有强制解除系统文件锁的能力。执行删除时如果遇到被进程/系统服务锁定的文件，模块会直接跳过该文件不抛出错误，最终表现为任务返回成功状态，但目录因为残留锁定文件未被完全删除。
  2. Windows用户目录默认存在多重锁定：只要用户曾经登录过，用户配置文件服务（ProfSvc）、Windows搜索索引、Defender实时防护都会持有该目录下文件的句柄；如果用户处于未完全登出状态（包括RDP断开未注销、后台有以该用户运行的服务/计划任务），整个目录会被系统完全锁定，普通权限下无法删除。
• 第二段配置报“目录正在使用”错误的原因
  win_file模块不存在name参数，你传入的name字段会被模块直接忽略，实际执行的操作是对path参数指定的C:\Users目录本身执行删除。该目录是系统核心目录，存放所有运行中用户的配置文件，当前Ansible连接用户的配置文件正处于加载使用状态，因此会触发占用报错，操作完全没有命中你要删除的myuser子目录。

必须提权到SYSTEM账户执行以下所有操作，普通管理员权限无法操作其他用户的配置文件锁：

1. 注销目标用户所有会话，终止残留进程

   - name: Logoff target user and kill remaining processes
     win_shell: |
       $targetUser = "myuser"
       # 注销所有该用户的活跃会话
       query user $targetUser 2>$null | ForEach-Object {
         $sessionId = ($_ -split '\s+')[2]
         if ($sessionId -match '^\d+$') { logoff $sessionId /server:localhost }
       }
       # 终止该用户名下所有残留进程
       Get-CimInstance Win32_Process | Where-Object {
         $owner = $_.GetOwner()
         $owner.User -eq $targetUser
       } | ForEach-Object { $_.Terminate() | Out-Null }
     become: yes
     become_method: runas
     become_user: SYSTEM
   

2. 删除用户配置文件的注册表挂载记录，解除ProfSvc服务的锁定
   用户登出后ProfSvc可能仍保留配置文件的挂载记录持续锁定目录，需要先清理对应注册表项：

   - name: Clean up user profile registry mount
     win_regedit:
       path: "HKLM:\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\ProfileList\\{{ item.Sid }}"
       state: absent
     loop: "{{ lookup('ansible.windows.win_user_profile', user_name='myuser') }}"
     become: yes
     become_method: runas
     become_user: SYSTEM
   

3. 执行目录删除操作，注意不要传入无效的name参数：

   - name: Remove target user profile directory
     win_file:
       path: C:\Users\myuser
       state: absent
     become: yes
     become_method: runas
     become_user: SYSTEM
   

注意：禁止直接对C:\Users根目录执行删除操作，该目录为Windows系统核心目录，即使提权到SYSTEM也无法完全删除，还会导致系统崩溃、所有用户无法登录。

内容的提问来源于stack exchange，提问作者r4koodli