New-CsNetworkMediaBypassConfiguration

구문

New-CsNetworkMediaBypassConfiguration [-AlwaysBypass <$true | $false>] [-BypassID <String>] [-Enabled <$true | $false>] [-EnableDefaultBypassID <$true | $false>] [-ExternalBypassMode <Nullable>] [-InternalBypassMode <Nullable>]

자세한 정보

이 cmdlet은 오디오 연결의 미디어 바이패스에 대한 글로벌 설정을 만듭니다.

Microsoft Lync Server 2010의 대부분의 New- cmdlet과 달리 이 cmdlet은 새 구성을 즉시 저장하지 않고 메모리에만 설정을 만듭니다. 이 cmdlet에 의해 생성된 개체는 변수에 저장된 다음 네트워크 구성의 MediaBypassSettings 속성에 할당됩니다. 자세한 내용은 이 항목의 예제 섹션을 참조하십시오.

이 cmdlet을 사용하여 만든 설정은 글로벌 네트워크 구성의 MediaBypassSettings 속성에 액세스해야만 검색할 수 있습니다. 이러한 설정을 검색하려면 (Get-CsNetworkConfiguration).MediaBypassSettings 명령을 실행합니다.

이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 New-CsNetworkMediaBypassConfiguration cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkMediaBypassConfiguration"}

매개 변수

입력 형식

없음.

반환 형식

Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.MediaBypassSettingsType 유형의 개체 참조를 만듭니다.

예제

-------------------------- 예제 1 --------------------------

$a = New-CsNetworkMediaBypassConfiguration -AlwaysBypass $true -Enabled $true
Set-CsNetworkConfiguration -MediaBypassSettings $a

이 예제의 명령은 미디어 바이패스를 사용하도록 설정하고 항상 바이패스를 시도하도록 구성합니다. 예제의 첫째 줄은 New-CsNetworkMediaBypassConfiguration cmdlet에 대한 호출입니다. 이 cmdlet에 AlwaysBypass와 Enabled의 두 매개 변수를 전달하고 둘 다 True($true)로 설정합니다. Enabled를 True로 설정하면 미디어 바이패스가 사용하도록 설정되고, AlwaysBypass를 True로 설정하면 모든 통화에 대해 미디어 바이패스가 시도됩니다. 이러한 두 매개 변수를 설정하면 BypassID 속성 값이 자동으로 생성됩니다. New-CsNetworkMediaBypassConfiguration은 메모리에만 개체를 만들기 때문에 해당 개체를 변수 $a에 할당합니다.

미디어 바이패스 구성은 네트워크 구성 설정에 저장됩니다. 따라서 예제의 둘째 줄에서 Set-CsNetworkConfiguration cmdlet을 호출하고, MediaBypassSettings 매개 변수에 첫째 줄에서 만든 미디어 바이패스 구성 개체($a)를 전달하여 네트워크 구성에 미디어 바이패스 구성 변경 사항을 저장합니다.

-------------------------- 예제 2 --------------------------

$a = (Get-CsNetworkConfiguration).MediaBypassSettings
$a.AlwaysBypass = $false
Set-CsNetworkConfiguration -MediaBypassSettings $a

Lync Server에는 Set-CsNetworkMediaBypassConfiguration cmdlet이 없습니다. 따라서 기존 설정을 수정하려면 예제 1에서 보는 바와 같이 새 구성을 만들어 기존 구성을 바꾸거나 기존 설정을 검색하여 수정한 다음 Set-CsNetworkConfiguration cmdlet을 사용하여 변경 사항을 저장하는 방법으로 설정을 수정해야 합니다. 이 예제는 후자 옵션을 사용하여 Always Bypass 옵션을 사용하지 않도록 설정하는 방법을 보여 줍니다.

이 예제의 첫째 줄에서는 기존 미디어 바이패스 설정을 검색합니다. 이 작업을 수행하기 위해 Get-CsNetworkConfiguration을 호출합니다. 이 cmdlet에 대한 호출은 명령의 다른 부분이 실행되기 전에 완료될 수 있도록 괄호 안에 들어 있습니다. Get-CsNetworkConfiguration은 전체 네트워크 구성의 모든 설정을 검색합니다. 미디어 바이패스 설정만 검색하면 되므로 이러한 설정만 검색하도록 MediaBypassSettings 속성을 지정합니다. 이러한 설정을 변수 $a에 할당합니다.

둘째 줄에서는 AlwaysBypass 속성에 False 값($false)을 할당하여 변수 $a에 저장된 설정을 수정합니다. 마지막으로 셋째 줄에서는 Set-CsNetworkConfiguration을 호출하고 MediaBypassSettings 매개 변수에 변수 $a를 전달하여 AllowBypass 속성에 대해 변경된 사항을 저장합니다.

참고 항목

기타 리소스

Get-CsNetworkConfiguration
Set-CsNetworkConfiguration