GeoSync cmdlet

在此部分：

关于 GeoSync

GeoSync 设置由个性化服务器随附的 cmdlet 执行。执行 Import-ApsInstancemodule 时，cmdlet 会自动导入到 PowerShell 会话中。

如果使用了默认 Environment Manager 安装位置，则 cmdlet 在以下位置：C:\Program Files\AppSense\Environment Manager\Personalization Server\Support

SQL 配置管理器帐户的默认日期格式必须与美国日期格式 (mm/dd/yyyy) 相匹配。如需详细信息，请参阅 GeoSync 帮助主题及该文章。

Cmdlet 说明 参数
New-EMPSPublisher 将特定数据库设置为 GeoSync 发布服务器。

此 cmdlet 在“实时”和“导出”两种模式下运行。在“导出”模式下，它会导出可用于数据库的脚本以执行操作。该脚本可以根据高级需求专门定制。

 常用参数：

-PublisherServer

-PublisherDatabase

-DisplayName

-Verbose

-ConfigurerCredential

-SecondaryReplicaServers

-DatabaseMasterKeyPassword

实时参数：

-ConfigurerCredential

导出参数：

-ExportScript

-ScriptFolder folder

-Force
Remove-EMPSPublisher 从特定数据库删除发布服务器功能。

如果已经删除所有订阅服务器，则此 cmdlet 会从数据库中删除发布服务器设置。如果无法正常删除订阅服务器，请使用 Reset-EMPSGeoSyncDatabase cmdlet。

此 cmdlet 在实时模式或导出模式下运行。

 常用参数：

-PublisherServer

-PublisherDatabase

-Verbose

-ConfigurerCredential PSCredential

实时参数：

-ConfigurerCredential PSCredential

导出参数：

-ExportScript

-ScriptFolder folder

-Force
Add-EMPSSubscriber 向发布服务器中添加订阅服务器数据库。

在实时模式下，必须可以访问发布服务器和订阅服务器。在导出模式下，会生成三个脚本：

  • 订阅服务器基本设置脚本 "Subscriber-subscriberid.sql"，执行订阅服务器上的基本设置。此脚本需要为创建的订阅服务器证书指定一个用于保存的证书文件夹。
  • 添加发布者引用脚本 "AddPublisherTo-subscrberid.sql"，向订阅服务器上的发布者添加引用。此脚本需要将发布服务器证书复制到订阅服务器上的指定证书文件夹。
  • 添加订阅者引用脚本 "Add-subscriberIdToPublisher.sql"，向发布服务器上的订阅者添加引用。此脚本需要将订阅服务器证书复制到发布服务器上的指定证书文件夹。
 常用参数：

-PublisherServer

-PublisherDatabase

-SubscriberServer

-SubscriberDatabase

-ServiceCredential PSCredential

-DisplayName

-Verbose

实时参数：

-ConfigurerCredential PSCredential

订阅服务器数据库和发布服务器数据库的配置者凭据必须相同。

导出参数：

-ExportScript

-ScriptFolder folder

-Force

-PublisherDisplayName
Remove-EMPSSubscriber 从发布服务器中删除并清理订阅者。

在实时模式下，必须可以访问发布服务器和订阅服务器。在导出模式下，会生成两个脚本：

  • RemoveSubscriber-subscriberid.sql
  • Remove-subscriberid.sql.
 常用参数：

-PublisherServer

-PublisherDatabase

-SubscriberServer

-SubscriberDatabase

-RemoveUsers

-Verbose（可选）

实时参数：

-ConfigurerCredential PSCredential

订阅服务器数据库和发布服务器数据库的配置者凭据必须相同。

导出参数：

-ExportScript

-ScriptFolder folder

-Force
Get-EMPSSubscribers 返回发布服务器的订阅者列表。

此 cmdlet 利用字符串属性 'ServerInstance' 和 'Database' 将对象列表写入输出管道。

 -PublisherServer

-PublisherDatabase

-ConfigurerCredential PSCredential
Reset-EMPSGeoSyncDatabase 从链接数据库可能不可用的单个数据库中删除 GeoSync 设置。

如果订阅服务器或发布服务器不可用，则用于删除 GeoSync 信息。此脚本只可在实时模式下运行。

如果指定 -SubscriberDisplayName，则会从发布服务器数据库中删除对该订阅者的引用。否则，将从任何数据库（发布服务器或订阅服务器）中删除所有 GeoSync 对象。

 -Server

-Database

-ConfigurerCredential

-SubscriberDisplayName

-Force
Start-EMPSBatchSync 以编程方式启动从指定发布服务器数据库到指定订阅服务器数据库的批量同步。

用于为任何匹配的订阅服务器启动批量同步。这相当于从控制台触发批量同步。这是一个异步命令。它将返回能反映请求状态的对象，但在同步完成之前不会阻止。

 -SubscriberDisplayName

-ConfigOnly
Stop-EMPSBatchSync 停止正在执行的批量同步。

用于为任何匹配的订阅服务器停止正在运行的批量同步。这相当于从控制台取消批量同步。这是一个异步命令。它将返回能反映请求状态的对象，但在取消完成之前不会阻止。

 -SubscriberDisplayName
Get-EMPSBatchSyncStatus 检索同步的状态。

用于返回任何匹配订阅服务器的同步状态。这与控制台中显示的状态相同。它将返回能反映请求状态的对象。

 -SubscriberDisplayName

参数定义

参数 说明
-PublisherServer

发布服务器的服务器名称。对于非默认实例，请使用“服务器\实例”格式。

设置可用性组中的发布服务器数据库时，该参数应指向主要副本。
-PublisherDatabase 发布服务器数据库名称。
-SubscriberServer 订阅服务器的服务器名称。对于非默认实例，请使用“服务器\实例”格式。
-SubscriberDatabase 订阅服务器数据库名称。
-DisplayName 可选的显示名称是指订阅服务器数据库中的发布者，和发布服务器数据库中的订阅者。如果忽略，则默认为服务器名称最左侧的组件。如果设置订阅者时此操作未产生唯一名称，则会显示错误。
-Verbose 显示详细输出 - 可选。
-ConfigurerCredential PSCredential 用于配置的凭据。如果忽略，则使用当前 Windows 凭据。如果用户名包含反斜杠，则系统会将该凭据视为 Windows 凭据，否则视为 SQL 凭据。

-SecondaryReplicaServers

以逗号分隔、托管次要副本数据库的数据库服务器列表。
如果 cmdlet 检测到发布服务器数据库在可用性组中，则您需要指定一个或多个次要副本数据库。

-DatabaseMasterKeyPassword

允许您指定用于加密凭据的主密钥密码。如果不指定该参数，cmdlet 会生成一个随机复杂密码。

在某些情况下，保留数据库主密钥非常重要。请参阅 GeoSync.htm
-ServiceCredential PSCredential 访问订阅服务器上服务的凭据（用于启动批量同步）。这必须是订阅服务器上的现有服务帐户。如果用户名包含反斜杠，则系统会将其视为 Windows 凭据，否则视为 SQL 凭据。
-ExportScript 指定导出模式。
-ScriptFolder folder （可选）指定要写入脚本的文件夹。可以是绝对路径，也可以是相对路径。如果文件夹不存在，只要其父文件夹存在，系统就会自动创建该文件夹。
-Force 如果指定，则系统会覆盖同名的现有脚本。指定订阅者显示名称或模式后，防止 cmdlet 在删除每个订阅者之前提示确认。
-PublisherDisplayName 订阅服务器数据库的发布者的可选显示名称。这应该与在发布服务器端创建的显示名称相匹配。
-Server 服务器名称。对于非默认实例，请使用“服务器\实例”格式。
-Database 数据库名称。
-SubscriberDisplayName 如果指定，则从发布服务器中删除与显示名称匹配的订阅者。名称中可能包含通配符 * 和 ?。如果未指定，则从（发布服务器或订阅服务器）数据库中删除所有 GeoSync 设置。
-ConfigOnly 启动“仅配置同步”。

生成脚本来配置 GeoSync

GeoSync cmdlet 可用于生成 SQL 脚本来设置和删除 GeoSync。如果用户没有足够的权限修改相应数据库，此命令会非常有用。相反，可以将脚本传递给数据库管理员执行。

利用 cmdlet New-EMPSPublisher、Add-EMPSSubscriber、Remove-EMPSSubscriber 和 Remove-EMPSPublisher 来指定 -ExportScript 参数后，则可使用导出模式。其他 cmdlet 不具备导出功能。

执行 Import-Apsinstancemodule 即可载入这些 cmdlet。如果用户不是管理员，这可能会导致警告，但不会影响脚本生成。

New-EMPSPublisher

如果指定 -ExportScript，则不能使用 -ConfigurerCredential，可以使用其他参数：

  • -ScriptFolder 会指定写入脚本的文件夹 - 如果忽略，则脚本会写入当前文件夹
  • -Force 会指示 cmdlet 覆盖同名脚本（如果存在）。

生成的脚本命名为 Publisher-<server>-<instance>-<database>.sql。可以针对发布服务器数据库使用 sqlcmd 来运行此脚本。如果使用了 SQL Server Management Studio，则使用的查询窗口必须处于 sqlcmd 模式。

与运行 cmdlet ‘live’ 不同，此操作不会检查是否已设置数据库。

Add-EMPSSubscriber

如果指定 -ExportScript，则不能使用 -ConfigureCredential，但可为 New-EMPSPublisher 使用 -ScriptFolder 和 -Force。必须指定 -ServiceCredential。Add-EMPSSubscriber 会生成三个脚本：

  • Subscriber-<server>-<instance>-<database>.sql - 应先对订阅服务器数据库运行此脚本，然后再进行基本设置。Server/instance/database 是指订阅服务器
  • Add-<server>-<instance>-<database>ToPublisher.sql - 在发布服务器上运行，以便向订阅者添加引用。
  • AddPublisherTo<server>-<instance>-<database>.sql - 在订阅服务器上运行，以便向发布者添加引用。

Remove-EMPSSubscriber

与 ExportScript 模式下的 Add-EMPSSubscriber 相似，但不需要 -ServiceCredential。生成两个脚本：

  • Remove-<server>-<instance>-<database>FromPublisher.sql - 在发布服务器上运行，以便删除订阅者引用。
  • RemoveSubscriber<server>-<instance>-<database>.sql - 在订阅服务器上运行，以便删除发布者引用和基本设置。

Remove-EMPSPublisher

如上所述，-ExportScript 附带 -Force 和 -ScriptFolder，但与 -ConfigurerCredential 无关。生成单个脚本：

  • RemovePublisher-<server>-<instance>-<database>FromPublisher.sql - 在发布服务器上运行，以便删除发布者并将数据库还原为标准个性化数据库。

相关主题

GeoSync