New-CsBlockedDomain
上次修改主題的時間： 2012-03-23
將網域新增至受同盟封鎖的網域清單中。依定義，不允許您的使用者使用 Microsoft Lync Server 2010 應用程式與封鎖網域的人員通訊，例如使用者無法運用 Microsoft Lync 2010 與任何他在封鎖清單上出現的網域中有 SIP 帳戶的使用者交換立即訊息。
語法
New-CsBlockedDomain -Identity <XdsGlobalRelativeIdentity> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
New-CsBlockedDomain -Domain <String> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
同盟是兩個組織用來建立信任關係的方法，以促進兩個群組之間的溝通。建立同盟後，兩個組織的使用者便可互相傳送立即訊息、訂閱目前狀態通知，並使用如 Lync 2010 等 SIP 應用程式互相通訊。Lync Server 2010 允許三種同盟：1) 您組織與其他組織之間的直接同盟；2) 您組織與公共供應商之間的同盟；3) 您組織與第三方代管供應商之間的同盟。
設定與其他組織的直接同盟需要幾項工作。若要開始，必須啟用執行 Lync Server Access Edge 服務的伺服器以允許同盟。此外，另一個組織必須允許與您同盟；雙方必須皆同意同盟關係，才能建立同盟。
若要建立同盟關係，可能也需要管理兩個與同盟相關的清單：允許清單與封鎖清單。允許清單代表您選擇要建立同盟的組織；如果網域出現在允許清單上 (取決於您的組態設定)，您的使用者便能與在該同盟網域中有帳戶的使用者交換立即訊息與目前狀態資訊。相反地，封鎖清單代表明確禁止使用者進行同盟的網域；例如，Lync Server 2010 會自動拒絕從封鎖網域傳送的訊息。
New-CsBlockedDomain 指令程式可讓您將網域新增至受封鎖的網域清單中。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsBlockedDomain Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsBlockedDomain"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
字串 |
要新增至封鎖清單之網域的完整網域名稱 (FQDN)，例如 "fabrikam.com"。您可以使用 Identity 或 Domain 參數 (但不得同時使用) 來指定網域名稱。如果使用 Identity，系統會將 Domain 屬性的值設為指派給 Identity 的值。如果使用 Domain，系統會將 Identity 屬性的值設為指派給 Domain 的值。 請注意，Identity 必須是唯一的。如果指定的網域已存在封鎖或允許的清單中，命令將會失敗。 |
Comment |
選用 |
字串 |
選用的字串值，可提供和封鎖之網域相關的額外資訊。例如，您可以加入 Comment 以說明網域遭到封鎖的原因。 |
Domain |
選用 |
字串 |
要新增至封鎖清單之網域的 FQDN (例如 fabrikam.com)。您可以使用 Identity 或 Domain 參數 (但不得同時使用) 來指定網域名稱。如果使用 Identity，系統會將 Domain 屬性的值設為指派給 Identity 的值。如果使用 Domain，系統會將 Identity 屬性的值設為指派給 Domain 的值。 請注意，Domain 必須是唯一的：如果指定的網域已存在封鎖或允許的清單中，命令將會失敗。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsBlockedDomain 不會接受管線傳送的輸入。
傳回類型
建立 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
New-CsBlockedDomain -Identity "fabrikam.com" -Comment "Blocked per Ken Myer."
上述範例可將 fabrikam.com 網域新增至封鎖網域的清單中。為達成此目的，會先呼叫 New-CsBlockedDomain 並搭配 Identity 參數，這樣會指派要封鎖之網域的名稱。此外，命令還加入了 Comment 參數以納入和封鎖之網域相關的註解。請注意，如果 fabrikam.com 已存在封鎖或允許的清單中，此命令將會失敗。
-------------------------- 範例 2 ------------------------
$x = New-CsBlockedDomain -Identity "fabrikam.com" -InMemory
$x.Comment = "Blocked per Ken Myer."
Set-CsBlockedDomain -Instance $x
範例 2 示範如何使用 InMemory 參數，針對原本只存在記憶體中的網域建立新的封鎖網域。在修改這個只存在於記憶體中之網域的內容值後，接著可呼叫 Set-CsBlockedDomain，將網域新增至封鎖清單中。
為了執行這項作業，命令的第一行需要使用 New-CsBlockedDomain 並搭配 InMemory 參數，以建立一個 Identity 為 fabrikam.com 的封鎖網域。完成建立後，這個虛擬網域即會儲存在變數 $x 中。
命令的第二行會修改虛擬網域的 Comment 屬性。完成上述作業後，第 3 行會使用 Set-CsBlockedDomain 指令程式將虛擬網域新增至封鎖的清單中。若未使用第三行的指令程式，虛擬網域便只會存在於記憶體中，且永遠無法新增至封鎖的清單中。反之，當您結束 Windows PowerShell 工作階段或刪除變數 $x 之後，虛擬網域便會立即消失。