PowerShell设置Excel单元格水平居中时变量赋值报错如何解决

报错原因 #

Excel COM对象的HorizontalAlignment属性仅接受16位整数（Int16）类型的输入：

• 直接写入-4108时，PowerShell会自动根据COM接口的要求将数值适配为Int16类型，因此可以正常运行
• 预先定义变量$xlCenter = -4108时，PowerShell默认将变量存储为32位整数（Int32）类型，赋值时不会主动做类型转换，因此触发"Unable to set the horizontal alignment of the range class"报错。

解决方案 #

方案1：定义常量时强制指定为Int16类型 #

在变量定义阶段就指定类型，后续可直接使用，符合在脚本开头统一存储常量的需求：

# 定义时强制转换为Int16类型
[Int16]$xlCenter = -4108 
$Excel = New-object -ComObject Excel.Application
$Excel.Visible = $false
$Filepath = "替换为你的Excel文件路径"
$Workbook = $Excel.Workbooks.Open($Filepath)
$Worksheet = $Workbook.Worksheets(1)
# 直接赋值即可正常运行
$Worksheet.Range("C1").HorizontalAlignment = $xlCenter

# 操作完成后务必释放COM对象，避免Excel进程残留后台
$Workbook.Save()
$Workbook.Close()
$Excel.Quit()
[System.Runtime.Interopservices.Marshal]::ReleaseComObject($Excel) | Out-Null
Remove-Variable Excel

方案2：赋值时临时转换类型 #

如果不想修改原有变量定义，可在赋值时单独做类型转换：

$Worksheet.Range("C1").HorizontalAlignment = [Int16]$xlCenter

方案3：直接调用Excel内置枚举（无需手动记忆数值） #

不需要手动查询对齐方式对应的数值，直接调用Excel官方提供的枚举值，可读性更高，不易出错：

$Excel = New-object -ComObject Excel.Application
$Excel.Visible = $false
# 直接调用内置枚举，支持所有Excel常量
$xlCenter = [Microsoft.Office.Interop.Excel.XlHAlign]::xlHAlignCenter
$xlRight = [Microsoft.Office.Interop.Excel.XlHAlign]::xlHAlignRight
$xlLeft = [Microsoft.Office.Interop.Excel.XlHAlign]::xlHAlignLeft

$Filepath = "替换为你的Excel文件路径"
$Workbook = $Excel.Workbooks.Open($Filepath)
$Worksheet = $Workbook.Worksheets(1)
$Worksheet.Range("C1").HorizontalAlignment = $xlCenter

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