如何以编程方式修改标准SharePoint页面顶部问号菜单的Help链接

以下几种编程方式可修改SharePoint页面顶部问号菜单下的Help链接：

方法1：PowerShell（支持SharePoint Server/Online） #

通过PnP PowerShell修改网站集的Help链接属性，适用于经典页面和部分现代页面场景：

# 连接到目标网站集
Connect-PnPOnline -Url "https://你的租户域名.sharepoint.com/sites/目标网站集" -Interactive

# 获取根网站对象并加载相关属性
$web = Get-PnPWeb -Includes HelpLink, HelpLinkEnabled

# 设置自定义Help链接并启用
$web.HelpLink = "https://你的自定义帮助页面地址"
$web.HelpLinkEnabled = $true

# 提交修改
Set-PnPWeb -Web $web

方法2：CSOM（C#代码） #

使用客户端对象模型编写代码修改，适合集成到自定义应用中：

using Microsoft.SharePoint.Client;
using System;
using System.Security;

namespace SharePointHelpLinkModifier
{
    class Program
    {
        static void Main(string[] args)
        {
            string siteUrl = "https://你的租户域名.sharepoint.com/sites/目标网站集";
            string userName = "你的账号@租户域名.onmicrosoft.com";
            string password = "你的密码";

            using (ClientContext context = new ClientContext(siteUrl))
            {
                // 初始化认证信息（SharePoint Online场景）
                SecureString securePwd = new SecureString();
                foreach (char c in password) securePwd.AppendChar(c);
                context.Credentials = new SharePointOnlineCredentials(userName, securePwd);

                // 加载网站的Help属性
                Web web = context.Web;
                context.Load(web, w => w.HelpLink, w => w.HelpLinkEnabled);
                context.ExecuteQuery();

                // 更新Help链接
                web.HelpLink = "https://你的自定义帮助页面地址";
                web.HelpLinkEnabled = true;
                web.Update();
                context.ExecuteQuery();

                Console.WriteLine("Help链接修改完成");
            }
        }
    }
}

方法3：SPFx应用自定义器（现代页面专属） #

如果是现代SharePoint页面，由于顶部菜单是客户端渲染，需用SPFx扩展修改DOM元素：

import { override } from '@microsoft/decorators';
import { Log } from '@microsoft/sp-core-library';
import { BaseApplicationCustomizer } from '@microsoft/sp-application-base';

const LOG_SOURCE: string = 'CustomHelpLinkApplicationCustomizer';

export interface ICustomHelpLinkApplicationCustomizerProperties {
  customHelpUrl: string;
}

export default class CustomHelpLinkApplicationCustomizer
  extends BaseApplicationCustomizer<ICustomHelpLinkApplicationCustomizerProperties> {

  @override
  public onInit(): Promise<void> {
    Log.info(LOG_SOURCE, "自定义Help链接扩展已初始化");

    // 等待页面DOM加载完成后执行修改
    window.addEventListener('load', () => {
      this.updateHelpLink();
    });

    return Promise.resolve();
  }

  private updateHelpLink(): void {
    // 定位帮助链接元素（DOM选择器需根据实际页面结构调整）
    const helpMenuItem = document.querySelector('div[aria-label="帮助"] a');
    if (helpMenuItem && this.properties.customHelpUrl) {
      helpMenuItem.setAttribute('href', this.properties.customHelpUrl);
      // 可选：修改链接显示文本
      // helpMenuItem.textContent = "自定义帮助中心";
    }
  }
}

注意事项 #

• 操作权限：需具备网站集管理员权限才能执行上述修改
• 页面类型：经典页面用前两种方法即可生效；现代页面优先使用SPFx方案，因为经典的Web属性修改可能不作用于客户端渲染的菜单
• 测试验证：修改完成后刷新页面，点击顶部问号菜单查看Help链接是否已更新

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