使用New-Item在TFS服务器创建文件失败，本地正常的问题咨询

我来帮你排查下这个TFS构建里PowerShell脚本创建文件失败的问题，结合我遇到过的类似场景，主要有这几个常见原因和对应的解决办法：

1. 构建服务账号的权限不足 #

本地运行脚本时用的是你自己的用户账号，对脚本所在目录肯定有读写权限，但TFS构建是用构建服务账号（比如Network Service、域账号或者专门的构建账号）执行的，这个账号很可能没有$ScriptDir对应目录的写入权限。

• 排查方法：在构建步骤里添加一条PowerShell命令，输出目标目录的权限信息：

  Get-Acl $ScriptDir | Format-List
  

• 解决办法：找到$ScriptDir对应的实际路径，给TFS构建服务账号添加写入和修改权限。

2. $ScriptDir变量在TFS环境中值不符合预期 #

本地运行时$ScriptDir = Split-Path $script:MyInvocation.MyCommand.Path能正确获取脚本所在路径，但在TFS构建中，脚本是从源代码管理下载到代理的工作目录，$MyInvocation的上下文可能和本地不一样，导致$ScriptDir是空值或者指向了一个不存在的路径。

• 排查方法：在New-Item命令前添加输出语句，确认$ScriptDir的实际值：

  Write-Host "当前ScriptDir路径：$ScriptDir"
  

• 解决办法：改用TFS预定义的环境变量来指定路径，比如：
  • 代码源目录：$env:BUILD_SOURCESDIRECTORY
  • 构建临时目录：$env:BUILD_STAGINGDIRECTORY
    或者用Join-Path更安全地拼接路径：

  $targetPath = Join-Path -Path $env:BUILD_SOURCESDIRECTORY -ChildPath "NITI_20180402.223.txt"
  New-Item -Path $targetPath -ItemType "file" -Value "This is a text string."
  

3. 未处理文件已存在的情况 #

如果目标文件已经存在，New-Item默认会抛出错误导致构建失败，而本地运行时你可能手动删除过文件，所以没遇到这个问题。

• 解决办法：添加-Force参数，允许覆盖已存在的文件：

  New-Item -Path $ScriptDir\NITI_20180402.223.txt -ItemType "file" -Value "This is a text string." -Force
  

4. PowerShell执行策略或代理限制 #

有些TFS代理可能设置了严格的PowerShell执行策略（比如Restricted），或者代理环境限制了文件创建操作。

• 排查方法：在构建步骤里添加命令查看执行策略：

  Get-ExecutionPolicy
  

• 解决办法：如果执行策略是Restricted，可以在脚本开头添加（需要管理员权限）：

  Set-ExecutionPolicy RemoteSigned -Scope Process -Force
  

  或者在TFS构建的PowerShell任务设置中，指定执行策略为RemoteSigned。

5. 路径拼接的语法问题 #

直接用$ScriptDir\NITI_20180402.223.txt拼接路径可能因为特殊字符、路径分隔符等问题出错，建议用PowerShell专门的路径拼接命令。

• 优化后的命令：

  $targetFile = Join-Path -Path $ScriptDir -ChildPath "NITI_20180402.223.txt"
  New-Item -Path $targetFile -ItemType "file" -Value "This is a text string." -Force
  

你可以先从排查$ScriptDir的值和权限问题入手，这两个是最常见的原因。

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