Get-CsAccessEdgeConfiguration
上次修改主題的時間： 2012-03-23
傳回您組織中執行 Access Edge Service 的電腦的相關資訊 (又稱為 Access Edge Server)。Access Edge Server 提供一種方式，讓內部網路外的使用者與內部網路內的使用者進行通訊。
語法
Get-CsAccessEdgeConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAccessEdgeConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
Access Edge Server (也稱為 Access Proxy 伺服器) 提供一種方式，讓您將 Microsoft Lync Server 2010 的功能擴大給未登入內部網路的人員使用。例如，如果您有遠端使用者 (不是透過內部網路，而是透過網際網路登入 Lync Server 2010 的已驗證使用者)，將需要設定 Access Edge Server。此外，如果您要與其他組織建立同盟，或者如果要賦予使用者與擁有公用立即訊息服務 (例如 Yahoo!、AOL 或 MSN) 帳戶之人員進行通訊的權限，也需要 Edge Server。Access Edge Server 位於周邊網路上，用來建立與驗證內部網路內部與外部使用者之間的 SIP 連線。
在 Lync Server 中，Access Edge Server 是使用單一個組態設定的通用集合來管理。Get-CsAccessEdgeConfiguration 指令程式可讓您傳回這些通用設定的相關資訊。請注意，Get-CsAccessEdgeConfiguration 傳回的屬性值會因您已針對 Edge Server 設定的路由類型而異。如需詳細資料，請參閱 Set-CsAccessEdgeConfiguration 說明主題。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsAccessEdgeConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAccessEdgeConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要傳回之 Access Edge 組態設定的唯一識別碼。因為您只能有一個這些設定的通用執行個體，因此在呼叫 Get-CsAccessEdgeConfiguration 時，不需要加入 Identity。然而，您可以使用下列語法擷取通用設定：-Identity global。 |
Filter |
選用 |
字串 |
可讓您在指定要傳回的 Access Edge 組態設定時使用萬用字元。因為您只能有一個這些設定的通用執行個體，因此幾乎沒有理由使用 Filter 參數。不過，如果您想要，可以使用類似如下語法來擷取通用設定：-Identity "g*"。 |
LocalStore |
選用 |
切換參數 |
從 中央管理存放區 的本機複本擷取 Access Edge 組態資料，而非從 中央管理存放區 本身擷取。 |
輸入類型
無。Get-CsAccessEdgeConfiguration 不會接受管線傳送的輸入。
傳回類型
Get-CsAccessEdgeConfiguration 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDnsSrvRouting 物件或 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayAccessEdgeSettingsDefaultRoute 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsAccessEdgeConfiguration
範例 1 會示範 Get-CsAccessEdgeConfiguration 的基本用法：呼叫不含任何額外參數的指令程式會傳回 Access Edge Server 實作的所有屬性值。請注意，不需要加入 Identity 或 Filter 參數；因為只有一組 Access Edge Server 組態資料。
-------------------------- 範例 2 ------------------------
Get-CsAccessEdgeConfiguration | Select-Object Allow*
以上的命令只會傳回 Access Edge Server 組態的三個屬性值：AllowAnonymousUsers、AllowFederatedUsers 及 AllowOutsideUsers。若要這樣做，此命令會先使用 Get-CsAccessEdgeConfiguration 傳回所有 Access Edge Server 屬性值。接著，此資訊會傳送到 Select-Object 指令程式，只挑出開頭字串值為 "Allow" 的屬性。因此，只有那些屬性值會顯示在畫面上。
-------------------------- 範例 3 ------------------------
(Get-CsAccessEdgeConfiguration).EnablePartnerDiscovery
範例 3 所示的命令會傳回單一 Access Edge Server 組態屬性的值：EnablePartnerDiscovery。若要這樣做，會先呼叫 Get-CsAccessEdgeConfiguration 以傳回所有 Access Edge Server 組態屬性值。這個 Get-CsAccessEdgeConfiguration 的呼叫會以括弧括住；這可確保 Windows PowerShell 先完成此命令，之後才執行其他任何工作。當傳回所有屬性值之後，會使用標準的「點標記法」( 物件名稱後面緊接著句號，再加上屬性名稱) 來顯示單一屬性的值：EnablePartnerDiscovery。