Get-CsNetworkConfiguration
上次修改主題的時間： 2012-03-23
擷取通話許可控制 (CAC)、增強型 9-1-1 (E9-1-1) 以及媒體旁路等的通用設定。
語法
Get-CsNetworkConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
網路組態物件包含 Microsoft Lync Server 2010 部署中針對媒體略過和整個 CAC 組態的所有通用設定，包括是否已啟用該組態。您可以使用此指令程式擷取這些組態和設定。不過，除了 EnableBandwidthPolicyCheck 和 MediaBypassSettings 之外，建議您在擷取 CAC 組態設定時使用物件類型專用的指令程式。例如，若要擷取網路區域，通常呼叫 Get-CsNetworkRegion 會比呼叫 Get-CsNetworkConfiguration，然後擷取該組態的 NetworkRegions 屬性更容易。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsNetworkConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
這一律為 Global。 |
Filter |
選用 |
字串 |
因為只會有一個網路組態，因此此指令程式不需要此參數。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區的本機複本擷取網路組態，而非從中央管理存放區本身擷取。 |
輸入類型
無。
傳回類型
Get-CsNetworkConfiguration 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsNetworkConfiguration
此範例會擷取網路組態設定。這些設定只會在全域範圍定義，因此只會傳回一個項目。
-------------------------- 範例 2 --------------------------
(Get-CsNetworkConfiguration).MediaBypassSettings
只有一組媒體旁路設定存在 (全域套用)。這些設定會儲存為整體網路組態的一部分。此命令會先呼叫 Get-CsNetworkConfiguration 來擷取該組態，然後再擷取該組態的 MediaBypassSettings 屬性。