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 資料夾

-Force
Remove-EMPSPublisher 自指定的資料庫移除發行者功能。

此 cmdlet 會自資料庫移除發行者設定，前提是已經移除所有訂閱者。如果無法以正常方式移除訂閱者，請使用 Reset-EMPSGeoSyncDatabase cmdlet。

此 cmdlet 會以即時模式或專家模式操作。

 通用參數:

-PublisherServer

-PublisherDatabase

-Verbose

-ConfigurerCredential PSCredential

即時參數:

-ConfigurerCredential PSCredential

匯出參數:

-ExportScript

-ScriptFolder 資料夾

-Force
Add-EMPSSubscriber 將訂閱者資料庫新增至發行者。

在即時模式中，發行者或訂閱者都必須可以進行存取。在匯出模式中，會產生三個指令碼:

  • 訂閱者基礎設定指令碼 "Subscriber-subscriberid.sql" 會執行有關訂閱者的基本設定。需要指定憑證資料夾以便儲存建立的訂閱者憑證。
  • 新增發行者參考指令碼 "AddPublisherTo-subscrberid.sql"，可將參考新增至訂閱者中的發行者。需要將發行者憑證複製到訂閱者中指定的憑證資料夾。
  • 新增發行者參考指令碼 "Add-subscriberIdToPublisher.sql"，可將參考新增至發行者中的訂閱者。需要將訂閱者憑證複製到發行者中指定的憑證資料夾。
 通用參數:

-PublisherServer

-PublisherDatabase

-SubscriberServer

-SubscriberDatabase

-ServiceCredential PSCredential

-DisplayName

-Verbose

即時參數:

-ConfigurerCredential PSCredential

訂閱者與發行者資料庫的配置程式認證必須相同。

匯出參數:

-ExportScript

-ScriptFolder 資料夾

-Force

-PublisherDisplayName
Remove-EMPSSubscriber 自發行者移除訂閱者並且清除訂閱者。

在即時模式中，發行者或訂閱者都需要可以進行存取。在專家模式中，會產生兩個指令碼:

  • RemoveSubscriber-subscriberid.sql
  • Remove-subscriberid.sql.
 通用參數:

-PublisherServer

-PublisherDatabase

-SubscriberServer

-SubscriberDatabase

-RemoveUsers

-Verbose (選用)

即時參數:

-ConfigurerCredential PSCredential

訂閱者與發行者資料庫的配置程式認證必須相同。

匯出參數:

-ExportScript

-ScriptFolder 資料夾

-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 資料夾 選擇性指定指令碼所寫入的資料夾。這可以是絕對或相對路徑。如果資料夾不存在，則會建立一個 - 只要其上層資料夾存在的話。
-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 不同的是，不會進行檢查以查看是否已經設定資料庫。

Add-EMPSSubscriber

如果指定了 -ExportScript，將不會使用 -ConfigureCredential，同時可使用 -ScriptFolder 和 -Force 作為 New-EMPSPublisher。必須指定 -ServiceCredential。Add-EMPSSubscriber 會產生三個指令碼:

  • Subscriber-<server>-<instance>-<database>.sql - 應該先對照訂閱者資料庫執行此指令碼以執行基礎設定。伺服器/執行個體/資料庫關聯至訂閱者
  • 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