Get-CsBlockedDomain
上次修改主題的時間： 2012-03-23
傳回關於已封鎖同盟之網域清單中包含的網域資訊。根據定義，您的使用者無法使用 Microsoft Lync Server 2010 應用程式與封鎖網域的人員進行通訊；例如，使用者無法使用 Microsoft Lync 2010 與在封鎖清單上的網域中擁有工作階段初始通訊協定 (SIP) 帳戶的任何人交換立即訊息。
語法
Get-CsBlockedDomain [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsBlockedDomain [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
「同盟」是兩個組織可建立信任關係的一種方法，此信任關係會簡化兩個團體之間的通訊。建立同盟後，兩個組織的使用者便可互相傳送立即訊息、訂閱目前狀態通知，並使用如 Lync 2010 等 SIP 應用程式互相通訊。Lync Server 2010 允許三種同盟：1) 您的組織與其他組織之間的直接同盟；2) 您的組織與公用提供者之間的同盟；以及 3) 您的組織與第三方代管供應商之間的同盟。
設定與其他組織間的直接同盟包含幾個工作。若要開始，必須將 Lync Server Access Edge 服務設為允許同盟。此外，另一個組織必須允許與您同盟；除非雙方都同意該關係，否則無法建立同盟。
若要設定同盟關係，您也可能需要管理兩個同盟相關清單：允許清單和封鎖清單。允許清單表示您已選擇與其同盟的組織；如果某個網域顯示在允許清單中，則 (根據您的組態設定而定) 您的使用者就可以與在該同盟網域中具有帳戶的使用者交換立即訊息及目前狀態資訊。相反地，封鎖清單代表明確禁止使用者進行同盟的網域；例如，Lync Server 2010 會自動拒絕從封鎖網域傳送的訊息。
Get-CsBlockedDomain 指令程式可讓您傳回關於出現在封鎖網域清單上之網域的資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsBlockedDomain Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsBlockedDomain"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
字串 |
要傳回之網域的名稱。網域會以其完整網域名稱 (FQDN) 列在封鎖清單上；因此，指定網域的 Identity 可能類似於 fabrikam.com 或 contoso.net。請注意，指定網域 Identity 時無法使用萬用字元。若要使用萬用字元傳回指定網域 (或一組網域)，請改用 Filter 參數。 如果未指定此參數，則會傳回封鎖網域清單上的所有網域。 |
Filter |
選用 |
字串 |
可讓您使用萬用字元，從封鎖網域清單傳回一或多個網域。若要傳回其 Identity 開頭為字母 "r" 的所有網域，請使用以下語法：-Filter r*。若要傳回其 Identity 結尾為 ".net" 的所有網域，請使用以下語法：-Filter "*.net"。若要傳回其 Identity 開頭為字母 "f" 或字母 "g" 的所有網域，請使用以下語法：-Filter [fg]*。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區的本機複本擷取封鎖的網域資料，而非從中央管理存放區本身擷取。 |
輸入類型
無。Get-CsBlockedDomain 不接受管線傳送的輸入。
傳回類型
傳回 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsBlockedDomain
範例 1 所示的命令會傳回包含在封鎖網域清單上的所有網域集合。這可以透過呼叫沒有任何額外參數的 Get-CsBlockedDomain 完成。
-------------------------- 範例 2 ------------------------
Get-CsBlockedDomain -Identity fabrikam.com
在範例 2 中，唯一傳回的是 Identity 為 "fabrikam.com" 的封鎖網域。封鎖清單上的網域必須擁有唯一識別碼，因此這個命令最多傳回一個原則。
-------------------------- 範例 3 ------------------------
Get-CsBlockedDomain -Filter *.net
範例 3 會使用 Filter 參數傳回 Identity 結尾為字串值 ".net" 之所有封鎖網域的集合。此範例命令會傳回如 northwindtraders.net、contoso.net 以及 fabrikam.net 之類的網域。
-------------------------- 範例 4 ------------------------
Get-CsBlockedDomain | Where-Object {$_.Comment -eq $Null}
以上的命令會傳回 Comment 屬性沒有值之所有網域的集合。若要這樣做，此命令會先使用 Get-CsBlockedDomain 傳回封鎖清單上所有網域的集合。接著將這個集合傳送到 Where-Object 指令程式，該指令程式只會選取 Comment 屬性等於 Null 值的網域。
-------------------------- 範例 5 ------------------------
Get-CsBlockedDomain | Where-Object {$_.Comment -match "Ken Myer"}
在範例 5 中，會傳回 Comment 屬性中某處包含字串值 "Ken Myer" 的所有封鎖網域。若要執行此工作，首先會呼叫 Get-CsBlockedDomain 以傳回封鎖網域清單上所有網域的集合。然後，此集合會傳送到 Where-Object，只挑出 Comment 屬性包含字串值 "Ken Myer" 的網域。