Set-CsBlockedDomain
上次修改主題的時間： 2012-03-26
修改已封鎖同盟之網域清單中包含的一或多個網域的 Comment 內容。根據定義，您的使用者無法使用 Microsoft Lync Server 2010 應用程式與封鎖網域的人員進行通訊；例如，使用者無法採用 Microsoft Lync 2010 與出現在封鎖清單上的網域中擁有 SIP 帳戶的任何人交換立即訊息。
語法
Set-CsBlockedDomain [-Identity <XdsGlobalRelativeIdentity>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsBlockedDomain [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
詳細描述
「同盟」是兩個組織可建立信任關係的一種方法，此信任關係會簡化兩個團體之間的通訊。建立同盟後，兩個組織的使用者便可互相傳送立即訊息、訂閱目前狀態通知，並使用如 Lync 2010 等 SIP 應用程式互相通訊。Lync Server 2010 允許三種同盟：1) 您的組織與其他組織之間的直接同盟；2) 您的組織與公用提供者之間的同盟；以及 3) 您的組織與第三方代管供應商之間的同盟。
設定與其他組織間的直接同盟包含幾個工作。首先，您必須啟用 Access Edge Server 以允許同盟。此外，另一個組織必須允許與您同盟；除非雙方都同意該關係，否則無法建立同盟。
若要設定同盟關係，您也可能需要管理兩個同盟相關清單：允許清單和封鎖清單。允許清單表示您已選擇與其同盟的組織；如果某個網域顯示在允許清單中，則 (根據您的組態設定而定) 您的使用者就可以與在該同盟網域中具有帳戶的使用者交換立即訊息及目前狀態資訊。相反地，封鎖清單代表明確禁止使用者進行同盟的網域；例如，Lync Server 2010 會自動拒絕從封鎖網域傳送的訊息。
Comment 內容 (封鎖網域中唯一可修改的內容) 用來儲存封鎖清單上的網域其他資訊 (例如，為何封鎖網域、何時可從封鎖清單中移除網域，或當您想要從封鎖清單中移除網域時應該連絡何人)。如果需要變更封鎖網域清單上任何網域的 Comment 屬性，請使用 Set-CsBlockedDomain 指令程式。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsBlockedDomain Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsBlockedDomain"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
字串 |
要修改 Comment 內容之封鎖清單的完整網域名稱 (FQDN)。例如：fabrikam.com |
Instance |
選用 |
BlockedDomain 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
Comment |
選用 |
字串 |
可讓您提供要修改之網域的其他資訊。例如，您可能會新增 Comment，其中指出網域放置在封鎖清單中的原因。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain 物件。Set-CsBlockedDomain 接受管線傳送的封鎖網域物件執行個體。
傳回類型
Set-CsBlockedDomain 不會傳回值或物件。指令程式而是會設定 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Set-CsBlockedDomain -Identity fabrikam.com -Comment "Block this domain pending legal review."
範例 1 所示的命令會修改 Identity 為 "fabrikam.com" 之封鎖網域的 Comment。在此範例中，Comment 參數會與參數值 "Block this domain pending legal review" 一起加入。
-------------------------- 範例 2 ------------------------
Get-CsBlockedDomain | Set-CsBlockedDomain -Comment "Block this domain pending legal review."
在以上的範例中，會更新封鎖網域清單中包含之所有網域的 Comment 屬性。若要這樣做，此命令會先呼叫 Get-CsBlockedDomain，這會傳回目前在封鎖網域清單上的所有網域集合。接著，該集合會傳送到 Set-CsBlockedDomain，這會繼續修改集合中每個網域的 Comment 屬性。
-------------------------- 範例 3 ------------------------
Get-CsBlockedDomain | Where-Object {$_.Comment -eq $Null} | Set-CsBlockedDomain -Comment "Block this domain pending legal review."
在範例 3 中，會為封鎖清單中還沒有設定 Comment 屬性值的每個網域新增一個註解 ("Block this domain pending legal review.")。若要執行此工作，此命令會先使用 Get-CsBlockedDomain 傳回目前在封鎖清單上所有網域的集合。然後，此集合會傳送到 Where-Object 指令程式，只挑出 Comment 屬性等於 Null 值的網域。接著，篩選過的集合會傳送到 Set-CsBlockedDomain，以便將相同的註解指派給此篩選過的集合中每個網域的 Comment 屬性。