New-CsConferencingConfiguration
마지막으로 수정된 항목: 2012-04-23
전화 회의 구성 설정의 새 컬렉션을 만듭니다. 전화 회의 설정은 전화 회의 콘텐츠 및 유인물에 허용되는 최대 크기, 콘텐츠 유예 기간(즉, 콘텐츠를 삭제하기 전까지 보관할 시간) 및 지원되는 클라이언트의 내부 및 외부 다운로드 URL 등과 같은 사항을 결정합니다.
구문
New-CsConferencingConfiguration -Identity <XdsIdentity> [-ClientAppSharingPort <UInt16>] [-ClientAppSharingPortRange <UInt32>] [-ClientAudioPort <UInt16>] [-ClientAudioPortRange <UInt32>] [-ClientFileTransferPort <UInt16>] [-ClientFileTransferPortRange <UInt32>] [-ClientMediaPort <UInt16>] [-ClientMediaPortRange <UInt32>] [-ClientMediaPortRangeEnabled <$true | $false>] [-ClientSipDynamicPort <UInt16>] [-ClientSipDynamicPortRange <UInt32>] [-ClientVideoPort <UInt16>] [-ClientVideoPortRange <UInt32>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-InMemory <SwitchParameter>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
자세한 정보
전화 회의의 경우 두 개의 cmdlet 집합으로 관리가 분할됩니다. 예를 들어 전화 회의에 참가하도록 익명 참여자를 초대할 수 있는지, 전화 회의에서 응용 프로그램 공유를 제공할 수 있는지, 전화 회의 내에서 파일을 전송할 수 있는지 등, 사용자가 수행할 수 있는 작업과 수행할 수 없는 작업을 관리하려면 CsConferencingPolicy cmdlet을 사용해야 합니다.
관리자는 웹 회의 서비스도 관리해야 합니다. 예를 들어 관리자는 단일 전화 회의에 할당된 콘텐츠 저장소의 최대 크기를 지정하고 전화 회의 콘텐츠가 자동으로 삭제되기 전 유예 기간을 지정하는 등의 작업을 수행할 수 있어야 합니다. 또한 응용 프로그램 공유 및 파일 전송과 같은 작업에 사용되는 포트를 지정할 수 있어야 합니다.
포트 지정과 같은 작업은 CsConferencingConfiguration cmdlet을 사용하여 관리할 수 있습니다. 이러한 cmdlet을 사용하여 실제 서버 자체를 관리할 수 있습니다. 전역, 사이트 및 서비스 범위에 적용할 수 있는 CsConferencingConfiguration cmdlet은 사용자가 전화 회의 중에 응용 프로그램을 공유할 수 있는지, 응용 프로그램 공유가 허용되는지를 지정하는 데 사용되지는 않지만 이러한 작업에 사용할 포트를 지정할 수는 있습니다. 마찬가지로 이 cmdlet을 사용하여 저장소 제한 및 만료 기간, 사용자가 전화 회의 도움말 및 리소스를 가져올 수 있는 내부 및 외부 URL에 대한 포인터 등을 지정할 수도 있습니다.
Microsoft Lync Server 2010을 설치하면 시스템에서 한 가지 전화 회의 구성 설정 컬렉션(글로벌 컬렉션)을 제공합니다. 사이트 또는 서비스의 사용자 지정 설정을 만들어야 하는 경우 New-CsConferencingConfiguration cmdlet을 사용하면 됩니다. 새 설정은 사이트 범위 또는 서비스 범위에만 적용할 수 있습니다. 전화 회의 구성 설정의 글로벌 컬렉션은 새로 만들 수 없습니다. 뿐만 아니라 사이트 또는 서비스는 설정 컬렉션을 둘 이상 호스팅할 수 없습니다. Redmond 사이트에 대한 새 설정을 만들려고 할 경우 Redmond 사이트에서 이미 전화 회의 구성 설정 컬렉션을 호스팅하고 있으면 명령이 실패합니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalServerAdmins 그룹의 구성원은 New-CsConferencingConfiguration cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsConferencingConfiguration"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds ID |
수정할 전화 회의 구성 설정 컬렉션의 고유 식별자입니다. 사이트 범위에서 구성된 컬렉션을 참조하려면 -Identity "site:Redmond"와 유사한 구문을 사용합니다. 서비스 범위에서 컬렉션을 참조하려면 -Identity "service:ConferencingServer:atl-cs-001.litwareinc.com"과 유사한 구문을 사용합니다. 이러한 구성 설정을 호스팅할 수 있는 서비스는 웹 회의 서비스뿐입니다. |
ClientAppSharingPort |
선택 |
정수 |
응용 프로그램 공유에 사용되는 시작 포트 번호를 나타냅니다. ClientAppSharingPort는 1024-65535(포함)의 값 포트 번호여야 합니다. 기본값은 5350입니다. |
ClientAppSharingPortRange |
선택 |
정수 |
응용 프로그램 공유에 사용할 수 있는 총 포트 수를 나타냅니다. 기본값은 40입니다. 응용 프로그램 공유에 사용되는 실제 포트를 확인하려면 이 값 및 ClientAppSharingPort 값을 사용하십시오. 예를 들어 ClientAppSharingPort를 5350으로 설정하고 ClientAppSharingPortRange를 3으로 설정하면 응용 프로그램 공유에 다음 세 개의 포트를 사용할 수 있습니다. 5350; 5351; 5352. |
ClientAudioPort |
선택 |
정수 |
클라이언트 오디오에 사용되는 시작 포트 번호를 나타냅니다. ClientAudioPort는 1024-65535(포함)의 값 포트 번호여야 합니다. 기본값은 5350입니다. |
ClientAudioPortRange |
선택 |
정수 |
클라이언트 오디오에 사용할 수 있는 총 포트 수를 나타냅니다. 기본값은 40입니다. 클라이언트 오디오에 사용되는 실제 포트를 확인하려면 이 값 및 ClientAudioPort 값을 사용하십시오. 예를 들어 ClientAudioPort를 5350으로 설정하고 ClientAudioPortRange를 3으로 설정하면 클라이언트 오디오에 다음 세 개의 포트를 사용할 수 있습니다. 5350; 5351; 5352. |
ClientFileTransferPort |
선택 |
정수 |
파일 전송에 사용되는 시작 포트 번호를 나타냅니다. ClientFileTransferPort는 1024-65535(포함)의 값 포트 번호여야 합니다. 기본값은 5350입니다. |
ClientFileTransferPortRange |
선택 |
정수 |
파일 전송에 사용할 수 있는 총 포트 수를 나타냅니다. 기본값은 40입니다. 파일 전송에 사용되는 실제 포트를 확인하려면 이 값 및 ClientFileTransferPort 값을 사용하십시오. 예를 들어 ClientFileTransferPort를 5350으로 설정하고 ClientFileTransferPortRange를 3으로 설정하면 파일 전송에 다음 세 개의 포트를 사용할 수 있습니다. 5350; 5351; 5352. |
ClientMediaPort |
선택 |
정수 |
클라이언트 미디어에 사용되는 시작 포트 번호를 나타냅니다. Microsoft Office Communicator 2007 R2 클라이언트에 대해 이 매개 변수를 사용합니다. ClientMediaPort는 1024-65535(포함)의 값 포트 번호여야 합니다. 기본값은 5350입니다. |
ClientMediaPortRange |
선택 |
정수 |
클라이언트 미디어에 사용할 수 있는 총 포트 수를 나타냅니다. 기본값은 40입니다. Office Communicator 2007 R2 클라이언트에 대해 이 매개 변수를 사용합니다. 클라이언트 미디어에 사용되는 실제 포트를 확인하려면 이 값 및 ClientMediaPort 값을 사용하십시오. 예를 들어 ClientMediaPort를 5350으로 설정하고 ClientMediaPortRange를 3으로 설정하면 클라이언트 미디어에 5350, 5351, 5352의 세 개 포트를 사용할 수 있습니다. |
ClientMediaPortRangeEnabled |
선택 |
부울 |
True로 설정하면 클라이언트가 미디어 트래픽에 지정된 포트 범위를 사용합니다. False(기본값)로 설정하면 사용 가능한 모든 포트(포트 1024-포트 65535)를 사용하여 미디어 트래픽을 수용합니다. |
ClientSipDynamicPort |
선택 |
정수 |
SIP 트래픽에 사용되는 시작 포트 번호를 나타냅니다. ClientSipDynamicPort는 1024-65535(포함)의 값 포트 번호여야 합니다. 기본값은 7100입니다. |
ClientSipDynamicPortRange |
선택 |
정수 |
SIP 트래픽에 사용할 수 있는 총 포트 수를 나타냅니다. 기본값은 3입니다. SIP 트래픽에 사용되는 실제 포트를 확인하려면 이 값 및 ClientSipDynamicPort 값을 사용하십시오. 예를 들어 ClientSipDynamicPort를 7100으로 설정하고 ClientSipDynamicPortRange를 3으로 설정하면 클라이언트 미디어에 다음 세 개의 포트를 사용할 수 있습니다. 7100; 7101; 7102. |
ClientVideoPort |
선택 |
정수 |
클라이언트 비디오에 사용되는 시작 포트 번호를 나타냅니다. ClientVideoPort는 1024-65535(포함)의 값 포트 번호여야 합니다. 기본값은 5350입니다. |
ClientVideoPortRange |
선택 |
정수 |
클라이언트 비디오에 사용할 수 있는 총 포트 수를 나타냅니다. 기본값은 40입니다. 클라이언트 비디오에 사용되는 실제 포트를 확인하려면 이 값 및 ClientVideoPort 값을 사용하십시오. 예를 들어 ClientVideoPort를 5350으로 설정하고 ClientVideoPortRange를 3으로 설정하면 클라이언트 비디오에 다음 세 개의 포트를 사용할 수 있습니다. 5350; 5351; 5352. |
ConsoleDownloadExternalUrl |
선택 |
문자열 |
외부 사용자가 지원되는 클라이언트(예: Microsoft Lync 2010)를 다운로드할 수 있는 URL입니다. 이 설정은 Lync Server 풀에 로그인 중인 레거시 클라이언트(예: Microsoft Office Communicator 2007 R2)에만 적용됩니다. |
ConsoleDownloadInternalUrl |
선택 |
문자열 |
내부 사용자가 지원되는 클라이언트(예: Microsoft Lync 2010)를 다운로드할 수 있는 URL입니다. 이 설정은 Lync Server 풀에 로그인 중인 레거시 클라이언트(예: Microsoft Office Communicator 2007 R2)에만 적용됩니다. |
ContentGracePeriod |
선택 |
시간 범위 |
모임이 끝난 후에 전화 회의 콘텐츠가 서버에 남아 있게 될 시간을 나타냅니다. ContentGracePeriod는 일.시간:분:초 형식을 사용하여 지정해야 합니다. 예를 들어 콘텐츠 유예 기간을 30일로 설정하려면 -ContentGracePeriod 30.00:00:00 구문을 사용하십시오. 콘텐츠 유예 기간은 30분(00:30:00)에서 180일(180.00:00:00)의 값으로 설정할 수 있습니다. 기본값은 15일(15.00:00:00)입니다. |
HelpdeskExternalUrl |
선택 |
문자열 |
전화 회의 중에 도움말을 클릭하는 외부 사용자에게 표시할 URL입니다. |
HelpdeskInternalUrl |
선택 |
문자열 |
전화 회의 중에 도움말을 클릭하는 내부 사용자에게 표시할 URL입니다. |
MaxBandwidthPerAppSharingServiceMb |
선택 |
정수 |
응용 프로그램 공유 회의 서비스에 대해 별도로 설정하는 대역폭의 최대 크기(MB)입니다. MaxBandwidthPerAppSharingServiceMb는 50-100000(포함)의 모든 정수 값으로 설정할 수 있습니다. 기본값은 375MB입니다. |
MaxContentStorageMb |
선택 |
정수 |
전화 회의 콘텐츠 저장소에 허용되는 파일 공간의 최대 크기(MB)입니다. MaxContentStorageMb는 50-1024(1GB)(포함)의 정수 값으로 설정할 수 있습니다. 기본값은 500입니다. |
Organization |
선택 |
문자열 |
전화 회의를 호스팅하는 조직의 이름입니다. |
InMemory |
선택 |
스위치 매개 변수 |
개체를 실제로 영구 변경 사항으로 커밋하지 않고 개체 참조를 만듭니다. 이 매개 변수와 함께 호출된 이 cmdlet의 결과를 변수로 할당하면 개체 참조의 속성을 변경한 후 이 cmdlet과 일치하는 Set- cmdlet을 호출하여 해당 변경 사항을 커밋할 수 있습니다. |
Force |
선택 |
스위치 매개 변수 |
명령을 실행할 때 발생할 수 있는 심각하지 않은 오류 메시지를 표시하지 않습니다. |
WhatIf |
선택 |
스위치 매개 변수 |
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다. |
Confirm |
선택 |
스위치 매개 변수 |
명령을 실행하기 전에 확인 메시지를 표시합니다. |
입력 형식
없음. New-CsConferencingConfiguration은 파이프라인된 입력을 허용하지 않습니다.
반환 형식
New-CsConferencingConfiguration은 Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings 개체의 새 인스턴스를 만듭니다.
예제
-------------------------- 예제 1 --------------------------
New-CsConferencingConfiguration -Identity site:Redmond -Organization Litwareinc
위의 명령은 Redmond 사이트(site:Redmond)의 전화 회의 구성 설정의 새로운 컬렉션을 만듭니다. 이 예제에는 Organization 속성을 Litwareinc로 설정하는 데 사용되는 추가 매개 변수 하나(Organization)가 포함됩니다. Redmond 사이트에 이미 전화 회의 구성 설정의 컬렉션이 있으면 이 명령은 실패합니다. 해당 컬렉션은 사이트별로 하나만 가질 수 있기 때문입니다.
-------------------------- 예제 2 --------------------------
$x = New-CsConferencingConfiguration -Identity site:Redmond -InMemory
$x.Organization = "Litwareinc"
Set-CsConferencingConfiguration -Instance $x
예제 2에서는 처음에 메모리에만 전화 회의 구성 설정의 새 컬렉션을 만든 다음 이러한 가상 설정을 나중에 Redmond 사이트에 적용합니다. 이렇게 하기 위해 예제의 첫 번째 명령은 New-CsConferencingConfiguration cmdlet을 사용하여 메모리에만 나타나는 새로운 설정 컬렉션을 만들고 변수 $x에 저장합니다. -InMemory 매개 변수는 컬렉션을 Redmond 사이트에 즉시 적용하지 않고 메모리에 만들도록 지정합니다.
컬렉션을 만든 후에는 두 번째 명령이 Organization 속성 값을 Litwareinc로 설정합니다. 마지막으로 세 번째 명령은 Set-CsConferencingConfiguration을 사용하여 실제로 Redmond 사이트에 새 설정을 적용합니다. site:Redmond에 전화 회의 구성 설정이 이미 적용된 경우에는 이 명령이 실패합니다. Set-CsConferencingConfiguration을 호출하지 않으면 새 설정이 적용되지 않습니다. 대신 Windows PowerShell 세션을 종료하거나 변수 $x를 삭제하자마자 이러한 설정이 사라집니다.