Set-CsVoiceConfiguration
마지막으로 수정된 항목: 2012-03-26
음성 테스트 구성 목록을 수정합니다.
구문
Set-CsVoiceConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]
자세한 정보
음성 테스트 구성은 특정 음성 정책, 경로 및 다이얼 플랜에 대해 전화 번호를 테스트하는 데 사용됩니다. 이 cmdlet을 사용하면 Microsoft Lync Server 2010 배포에 대한 모든 음성 테스트 구성을 포함하는 목록에서 음성 테스트 구성을 수정할 수 있습니다.
이 cmdlet은 VoiceConfiguration 유형의 개체를 수정합니다. 이 개체는 음성 테스트 구성의 컨테이너 개체일 뿐입니다. 따라서 이 cmdlet을 사용하지 않는 것이 좋습니다. 음성 구성을 수정하려면 Set-CsVoiceTestConfiguration cmdlet을 호출하여 개별 음성 테스트 구성을 수정합니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 Set-CsVoiceConfiguration cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsVoiceConfiguration"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
문자열 |
이 개체의 범위입니다. 이 매개 변수에 가능한 값은 Global뿐입니다. |
Instance |
선택 |
음성 구성 |
음성 구성(Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration) 개체에 대한 참조입니다. 이 유형의 개체는 Get-CsVoiceConfiguration cmdlet을 호출하여 검색할 수 있습니다. |
VoiceTestConfigurations |
선택 |
PS 목록 한정자 |
Lync Server 2010 배포에 대해 정의된 모든 음성 테스트 구성(Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration 개체)의 목록입니다. Set-CsVoiceTestConfiguration cmdlet을 사용하여 개별 음성 테스트 구성 개체를 수정해야 합니다. 이 목록의 구성을 수정할 때 이 방법을 사용하는 것이 좋습니다. |
Force |
선택 |
스위치 매개 변수 |
변경 내용을 적용하기 전에 표시될 수 있는 확인 메시지를 숨깁니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration 개체입니다. 음성 구성 개체의 파이프라인된 입력을 허용합니다.
반환 형식
Set-CsVoiceConfiguration은 값이나 개체를 반환하지 않습니다. 대신에 이 cmdlet은 Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration 개체의 인스턴스를 구성합니다.
예제
-------------------------- 예제 1 --------------------------
$a = Get-CsVoiceConfiguration
$b = $a.VoiceTestConfigurations | Where-Object {$_.Name -eq "TestConfig2"}
$b.DialedNumber = 5551212
$b.ExpectedTranslatedNumber = +5551212
Set-CsVoiceConfiguration -Instance $a
이 예제에서는 음성 구성 내의 테스트 음성 구성을 수정하기 위해 여러 단계를 거칩니다. 먼저 Get-CsVoiceConfiguration을 호출하여 음성 구성 개체를 검색합니다. 검색된 개체(하나만 있음)를 변수 $a에 할당합니다.
이 예제의 둘째 줄에서는 음성 테스트 구성 개체의 컬렉션인 변수 $a에서 VoiceTestConfigurations 속성의 내용을 검색합니다. 그런 다음 해당 컬렉션을 문자열 TestConfig2와 일치하는 Name을 가진 모든 음성 테스트 구성 개체에 대한 컬렉션을 검색하는 Where-Object에 파이프합니다. 해당 개체는 변수 $b에 할당됩니다.
다음으로 새 값을 DialedNumber 및 ExpectedTranslatedNumber 속성에 할당하여 TestConfig2 음성 테스트 구성 개체를 수정합니다. 해당 개체를 업데이트하여 변수 $a에서 개체를 업데이트했습니다. 그러나 해당 개체는 여전히 메모리에만 있습니다. 마지막 단계에서는 $a를 Set-CsVoiceConfiguration의 Instance 매개 변수에 전달하여 이러한 변경 내용을 저장해야 합니다.
이 방법을 사용하여 음성 구성을 수정하지 않는 것이 좋습니다. 음성 구성을 수정하려면 다음과 같은 Set-CsVoiceTestConfiguration 속성을 사용하여 개별 음성 테스트 구성을 변경하면 됩니다.
Set-CsVoiceTestConfiguration -Identity TestConfig2 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212
한 줄의 명령으로 예제 1에 표시된 것과 동일한 작업을 수행할 수 있습니다.