Outlook签名PowerShell脚本部分测试用户运行异常求助

云上老周

2026-6-29

问题描述

通过GPO运行PowerShell自动化脚本生成Outlook签名，流程为：从存储服务器拉取模板文件→复制到本地Outlook签名路径→将模板中的占位符替换为AD用户数据→把生成的签名文件复制回服务器，供Exchange脚本设置为OWA签名。脚本在测试用户端运行正常，但部分用户出现以下异常：

签名文件名正常，但所有占位符被替换为空或逗号，签名无有效用户数据
签名内容格式正常，但德语变音符号（äüöÄÖÜ）被替换为问号，例如“München”显示为“M?nchen”

脚本内容

# 读取Outlook离线文件(.ost)名称并赋值变量
$UserName = $env:USERNAME
$OstName = (Get-ChildItem -Path "$env:LOCALAPPDATA\Microsoft\Outlook\*.ost").Basename
$FileName = "Signatur ($OstName)"
$TemplateFileName = "test-signatur-template"
$FileExtension = "htm", "txt", "rtf"

# 模板文件存储路径
$PathSignaturTemplates = "REMOVED-FOR-PRIVACY-REASONS\templates"
# 本地Outlook签名路径
$PathSignaturUser = "$env:AppData\Microsoft\Signatures"
# 生成的签名文件复制到服务器的路径（供OWA使用）
$PathSignaturAufSYSVOL = "REMOVED-FOR-PRIVACY-REASONS\user-signaturen"

# 安装PowerShell AD模块（如果未安装）
Get-WindowsCapability -Online | Where-Object { $_.Name -match "Rsat.ActiveDirectory" -and $_.State -eq "NotPresent" } | Add-WindowsCapability -Online

# 读取AD用户数据
$Table = Get-ADUser $UserName -Properties City, Company, Mail, OfficePhone, PostalCode, StreetAddress, Title

# 如果用户未设置办公电话，填充默认值
if ($Table.OfficePhone -eq "" -or $Table.OfficePhone -eq $null){
        $Table.OfficePhone="REMOVED-FOR-PRIVACY";
    }

# 将模板文件复制到本地签名路径
foreach ($Ext in $FileExtension) {
    Copy-Item -Force "$PathSignaturTemplates\$TemplateFileName.$Ext" "$PathSignaturUser\$FileName.$Ext"
}

# 替换模板中的占位符为AD用户数据
foreach ($Ext in $FileExtension) {
    (Get-Content -Path "$PathSignaturUser\$FileName.$Ext") |
    ForEach-Object { $_ -replace "@VORNAME@", $Table.GivenName  } |
    ForEach-Object { $_ -replace "@NACHNAME@", $Table.Surname } |
    ForEach-Object { $_ -replace "@TITLE@", $Table.Title } |
    ForEach-Object { $_ -replace "@MAIL@", $Table.Mail } |
    ForEach-Object { $_ -replace "@NAME@", $Table.Name } |
    ForEach-Object { $_ -replace "@PHONE@", $Table.OfficePhone } |
    ForEach-Object { $_ -replace "@POSTCODE@", $Table.PostalCode } |
    ForEach-Object { $_ -replace "@STREET@", $Table.StreetAddress } |
    ForEach-Object { $_ -replace "@CITY@", $Table.City } |
    Set-Content -Force -Path "$PathSignaturUser\$FileName.$Ext"

    # 将生成的签名文件复制到服务器供OWA使用
    Copy-Item -Force -Path "$PathSignaturUser\$FileName.$Ext" "$PathSignaturAufSYSVOL\$FileName.$Ext"
}

# 如果用户职位是Technik或IT，生成额外签名（仅本地使用）
if ($Table.title -eq "Technik" -or $Table.title -eq "IT") {
    $NewTitle = $Table.Title
    $FileNameNew = "$NewTitle Signatur ($OstName)"
    $Table.OfficePhone = "REMOVED-FOR-PRIVACY"
    $Table.Mail = "REMOVED-FOR-PRIVACY"

    foreach ($Ext in $FileExtension) {
        Copy-Item -Force "$PathSignaturTemplates\$TemplateFileName.$Ext" "$PathSignaturUser\$FileNameNew.$Ext"
    }
    foreach ($Ext in $FileExtension) {
        (Get-Content -Path "$PathSignaturUser\$FileNameNew.$Ext") |
        ForEach-Object { $_ -replace "@VORNAME@", $Table.GivenName  } |
        ForEach-Object { $_ -replace "@NACHNAME@", $Table.Surname } |
        ForEach-Object { $_ -replace "@TITLE@", $Table.Title } |
        ForEach-Object { $_ -replace "@MAIL@", $Table.Mail } |
        ForEach-Object { $_ -replace "@NAME@", $Table.Name } |
        ForEach-Object { $_ -replace "@PHONE@", $Table.OfficePhone } |
        ForEach-Object { $_ -replace "@POSTCODE@", $Table.PostalCode } |
        ForEach-Object { $_ -replace "@STREET@", $Table.StreetAddress } |
        ForEach-Object { $_ -replace "@CITY@", $Table.City } |
        Set-Content -Force -Path "$PathSignaturUser\$FileNameNew.$Ext"
    }
}

# 设置生成的签名为新建邮件/回复邮件默认签名
$Path = "HKCU:\Software\Microsoft\Office\16.0\Common\MailSettings"
Remove-Item -Path $Path -Force -ErrorAction SilentlyContinue
New-Item -Path $Path -ErrorAction SilentlyContinue
New-ItemProperty -Path $Path -Force -Name "NewSignature" -PropertyType ExpandString -Value $FileName
New-ItemProperty -Path $Path -Force -Name "ReplySignature" -PropertyType ExpandString -Value $FileName

模板文件示例

Mit freundlichen Grüßen
@VORNAME@ @NACHNAME@
@TITLE@
--
REMOVED-FOR-PRIVACY
@STREET@, @POSTCODE@ @CITY@
Email: @MAIL@
Tel.: @PHONE@
REMOVED-FOR-PRIVACY
REMOVED-FOR-PRIVACY
REMOVED-FOR-PRIVACY
REMOVED-FOR-PRIVACY
REMOVED-FOR-PRIVACY
REMOVED-FOR-PRIVACY

排查与修复方案

针对占位符替换为空/逗号问题

可能原因

AD属性读取失败：Get-ADUser未正确获取用户属性，可能是用户AD账户缺失对应字段，或GPO脚本运行权限不足无法读取AD数据
OST文件异常：用户本地存在多个OST文件，导致$OstName返回数组，后续文件名和替换逻辑混乱；或脚本执行过早，OST文件尚未生成，$OstName为空
脚本无错误捕获：AD读取失败时脚本未中断，继续执行空值替换

修复措施

添加AD读取错误捕获与属性校验
修改AD数据读取部分，添加异常捕获，并为空属性设置默认值：

try {
    $Table = Get-ADUser $UserName -Properties City, Company, Mail, OfficePhone, PostalCode, StreetAddress, Title -ErrorAction Stop
} catch {
    Write-EventLog -LogName Application -Source "Outlook Signature Script" -EventId 1001 -EntryType Error -Message "读取AD用户数据失败: $_"
    exit 1
}
# 关键属性为空时设置默认值
$Table.GivenName = $Table.GivenName ?? $UserName
$Table.Surname = $Table.Surname ?? ""
$Table.Title = $Table.Title ?? ""
$Table.Mail = $Table.Mail ?? "$UserName@domain.com"

修复OST文件名获取逻辑
处理多OST文件或OST未生成的场景：

$ostFiles = Get-ChildItem -Path "$env:LOCALAPPDATA\Microsoft\Outlook\*.ost" -ErrorAction SilentlyContinue
if ($ostFiles.Count -ge 1) {
    $OstName = $ostFiles[0].Basename
} else {
    #  fallback到AD邮箱前缀或用户名
    $OstName = $Table.Mail.Split("@")[0] ?? $UserName
}

调整脚本执行时机
在GPO中设置脚本延迟执行（如登录后延迟10秒），或改用Outlook触发的脚本，确保OST文件已生成。

针对德语变音符号乱码问题

可能原因

文件编码不匹配：Get-Content和Set-Content默认使用系统ANSI编码，而模板文件为UTF-8编码，读取/写入时特殊字符被损坏；复制模板文件时未保留UTF-8编码。

修复措施

强制使用UTF-8编码读写文件
修改文件读取、写入和复制逻辑，指定-Encoding UTF8参数：

# 替换模板复制逻辑，确保编码一致
foreach ($Ext in $FileExtension) {
    Get-Content -Path "$PathSignaturTemplates\$TemplateFileName.$Ext" -Encoding UTF8 |
    Set-Content -Path "$PathSignaturUser\$FileName.$Ext" -Encoding UTF8 -Force
}

# 替换占位符时指定编码
foreach ($Ext in $FileExtension) {
    (Get-Content -Path "$PathSignaturUser\$FileName.$Ext" -Encoding UTF8) |
    ForEach-Object { $_ -replace "@VORNAME@", $Table.GivenName  } |
    # ... 其他替换逻辑 ...
    Set-Content -Force -Path "$PathSignaturUser\$FileName.$Ext" -Encoding UTF8

    # 复制到服务器时也用编码指定方式
    Get-Content -Path "$PathSignaturUser\$FileName.$Ext" -Encoding UTF8 |
    Set-Content -Path "$PathSignaturAufSYSVOL\$FileName.$Ext" -Encoding UTF8 -Force
}

确保模板文件编码正确
将服务器上的模板文件保存为UTF-8无BOM格式，避免编码识别冲突。

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

Outlook签名PowerShell脚本部分测试用户运行异常求助

针对占位符替换为空/逗号问题 #

可能原因 #

修复措施 #

针对德语变音符号乱码问题 #

可能原因 #

修复措施 #

针对占位符替换为空/逗号问题

可能原因

修复措施

针对德语变音符号乱码问题

可能原因

修复措施