Publish-CsTopology
上次修改主題的時間： 2012-03-25
發佈使用 Get-CsTopology 指令程式擷取的 Microsoft Lync Server 2010 拓撲。
語法
Publish-CsTopology -FileName <String> [-BackupFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Publish-CsTopology -Document <XElement> [-BackupFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Publish-CsTopology -FinalizeUninstall <SwitchParameter> [-BackupFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
安裝 Lync Server 2010 之後，您終將需要變更 Lync Server 基礎結構；例如，可能需要新增站台、刪除現有的登錄器集區或新增其他封存伺服器。您必須使用拓撲產生器來完成這些基礎結構變更。在 拓撲產生器 中完成變更後，接下來便能使用相同的工具來發佈及啟用變更。後面兩個步驟非常重要：儘管您可以使用 拓撲產生器 視需求做出修改，不過在發佈及啟用新拓撲之前這些修改並不會生效，而您的 Lync Server 基礎結構也不會變更。
雖然在發佈變更時，系統會將新資訊 (例如，新站台或新伺服器角色) 寫入 中央管理存放區。不過這些新物件 (或新修改的物件) 並不會立即加入您的拓撲中，而是必須等到更新過的拓撲啟用後才會加入。當您在 拓撲產生器 中選取 [發佈] 選項時，以下兩個步驟都會發生：發佈變更 (寫入 中央管理存放區)，然後再啟用新拓撲。
Publish-CsTopology 指令程式不再是發佈使用拓撲產生器建立之拓撲的建議方法；而應改用上一段中概述的步驟，在拓撲產生器內完成發佈。這是因為拓撲產生器現在會使用拓撲產生器 XML 檔案格式 (.tbxml)；此檔案格式無法使用 Publish-CsTopology 來發佈。您唯一需要利用 Publish-CsTopology 來做的是重新發佈使用 Get-CsTopology 指令程式擷取的拓撲。以此方式發佈拓撲之後，接著需重新設定簡易 URL。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Publish-CsTopology Cmdlet：RTCUniversalServerAdmins。但是，如果尚未指派設定權限，則您必須是網域系統管理員，才能執行 Publish-CsTopology。若要給予 RTCUniversalServerAdmins 實際使用 Publish-CsTopology 指令程式的權限，您必須在每個包含執行 Lync Server 服務之電腦的 Active Directory 容器上執行 Grant-CsSetupPermission 指令程式。請注意，此限制也適用於透過拓撲產生器啟用拓撲。如果尚未使用 Set-CsSetupPermission 來指派權限，則只有網域系統管理員能夠透過拓撲產生器來發佈拓撲。
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
FileName |
必要 |
字串 |
含有新拓撲資訊之 XML 檔案的完整路徑。 |
BackupFileName |
選用 |
字串 |
執行 Publish-CsTopology 時自動建立之備份檔案的完整路徑。如果不指定這個參數，Publish-CsTopology 便會在暫存資料夾 (%temp%) 中建立和以下範例相似的備份檔案：Publish-CsTopology-Backup-[2010_10_01][08_30_00]。在上述檔案名稱中，2010_10_01 代表發佈的日期：年 (2010)、月 (10) 及日 (01)。此外，08_30_00 代表發佈當日的時間：小時 (08)、分鐘 (30) 及秒 (00)。 |
Document |
選用 |
System.XML.Linq.XElement 物件 |
可讓您發佈 XML 元素，而非 XML 檔案。這個 XML 元素必須以 System.XML.Linq.XElement 物件的形式加以設定。 |
FinalizeUninstall |
選用 |
切換參數 |
只有在解除安裝 Lync Server 2010 時才會使用。在移除中央管理伺服器之後，會使用 Publish-CsTopology 和 FinalizeUninstall 參數發行空白拓撲。這會移除中央管理伺服器的所有 Active Directory 項目及執行其他功能。 |
GlobalCatalog |
選用 |
字串 |
網域中通用類別目錄伺服器的完整網域名稱 (FQDN)。如果您執行 Publish-CsTopology 的電腦帳戶是在您的網域中，就不需要此參數。 |
GlobalSettingsDomainController |
選用 |
字串 |
儲存通用設定之網域控制站的 FQDN。如果通用設定是儲存在 Active Directory 網域服務 (AD DS) 的系統容器內，則此參數必須導向根網域控制器。如果通用設定儲存在組態容器中，則會使用任何一個網域控制站，且會省略此參數。 |
SkipPrepareCheck |
選用 |
布林值 |
如果設為 True ($True)，Publish-CsTopology 會略過最初的準備檢查。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
Report |
選用 |
字串 |
可讓您指定在指令程式執行時所建立記錄檔的檔案路徑。例如：-Report "C:\Logs\Publish_Topology.html" |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。Publish-CsTopology 不會接受管線傳送的輸入。
傳回類型
無。而 Publish-CsTopology 會發佈 Microsoft.Rtc.Management.Deploy.Internal.DefaultTopology 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
(Get-CsTopology -AsXml).ToString() > C:\Topologies\Topology.xml
Publish-CsTopology -FileName "C:\Topologies\Topology.xml"
範例 1 所示的命令會擷取目前的拓撲，然後再重新發佈。為了執行這些作業，範例中的第一個命令會使用 Get-CsTopology 和 AsXml 參數來擷取目前的拓撲；接著使用 Windows PowerShell 重新導向符號 (>)，將擷取的資料儲存至名為 C:\Topologies\Topology.xml 的檔案中 (請注意，可使用 ToString 方法，將擷取的拓撲轉換成字串值)。接著，範例中的第二個命令會使用 Publish-CsTopology，重新發佈新擷取的拓撲。