Get-CsDialInConferencingAccessNumber

구문

Get-CsDialInConferencingAccessNumber [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

Get-CsDialInConferencingAccessNumber [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-Region <String>] [-ResultSize <Unlimited>]

Get-CsDialInConferencingAccessNumber -EmptyRegion <SwitchParameter> [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

자세한 정보

전화 접속 회의를 사용하여 사용자는 모든 종류의 전화기(예: 표준 "유선전화", 휴대폰 또는 VoIP(Voice over Internet Protocol 전화)를 사용하여 온라인 회의의 오디오 부분에 참가할 수 있습니다. 그러면 컴퓨터나 인터넷 연결이 없어도 모임에 참가할 수 있습니다. 사용자는 모든 오디오 기능을 이용할 수 있습니다. 즉, 다른 참가자에게 말하고 모든 진행 상황을 들을 수 있습니다. 그러나 공유 슬라이드, 화상 공급 또는 기타 시각적 요소는 볼 수 없습니다.

사용자에게 전화 접속 회의 기능을 제공하려면 전화 접속 회의 액세스 번호를 만들어야 합니다. 이 번호는 사용자가 모임에 연결하기 위해 전화 걸 수 있는 전화 번호입니다. 전화 접속 회의 액세스 번호는 New-CsDialInConferencingAccessNumber cmdlet을 사용하여 만듭니다. 새 전화 접속 회의 액세스 번호를 만드는 작업은 실제로는 AD DS(Active Directory 도메인 서비스)에 새 대화 상대 개체를 만드는 작업입니다. 이 대화 상대 개체는 액세스 번호 및 모든 해당 특성을 나타내는 데 사용됩니다. 연락처 번호는 Get-CsDialInConferencingAccessNumber cmdlet을 사용하여 검색할 수 있습니다.

Microsoft Office Communications Server 2007에서 전화 접속 회의 액세스 번호를 가져온 경우 Get-CsDialInConferencingAccessNumber를 실행하고 Region 매개 변수를 포함하여 이러한 번호를 검색할 수도 있습니다. 가져온 번호는 Region 매개 변수를 사용해야 표시됩니다. 그러나 가져온 번호의 URI(Uniform Resource Identifier) 외에도 경고 메시지가 표시됩니다. 이는 cmdlet이 가져온 전화 접속 회의 액세스 번호를 처리하는 방식입니다.

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

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

매개 변수

입력 형식

문자열. Get-CsDialInConferencingAccessNumber는 액세스 번호의 ID를 나타내는 문자열 값을 허용합니다.

반환 형식

Get-CsDialInConferencingAccessNumber는 Microsoft.Rtc.Management.Xds.AccessNumber 개체의 인스턴스를 반환합니다.

예제

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

Get-CsDialInConferencingAccessNumber

예제 1에 표시된 명령은 조직에서 사용하도록 구성된 모든 전화 접속 회의 액세스 번호의 컬렉션을 반환합니다. 추가 매개 변수 없이 Get-CsDialInConferencingAccessNumber를 호출하면 항상 사용 가능한 모든 전화 접속 액세스 번호의 컬렉션이 반환됩니다.

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

Get-CsDialInConferencingAccessNumber -Identity sip:RedmondDialIn@litwareinc.com

예제 2에서는 ID가 sip:RedmondDialIn@litwareinc.com인 전화 접속 회의 액세스 번호가 반환됩니다. ID는 고유해야 하므로 이 명령은 둘 이상의 액세스 번호를 반환하지 않습니다.

-------------------------- 예제 3 --------------------------

Get-CsDialInConferencingAccessNumber -Region "Redmond"

예제 3에서는 Region 매개 변수를 사용하여 Redmond 지역과 연결된 모든 전화 접속 회의 액세스 번호를 반환합니다. 이 작업을 수행하기 위해 Get-CsDialInConferencingAccessNumber가 Region 매개 변수와 함께 호출합니다. "Redmond"를 매개 변수 값으로 지정하면 Get-CsDialInConferencingAccessNumber는 연결된 지역 목록에 "Redmond"가 나타나는 모든 번호를 반환합니다. 예를 들어 지역으로 Redmond만 나열된 액세스 번호와 Redmond와 Portland가 모두 나열된 액세스 번호가 반환됩니다.

-------------------------- 예제 4 --------------------------

Get-CsDialInConferencingAccessNumber -Region $Null

위 명령은 지역과 연결되지 않은(즉, Regions 속성이 비어 있는) 모든 전화 접속 회의 액세스 번호를 반환합니다.

-------------------------- 예제 5 ------------------------

Get-CsDialInConferencingAccessNumber -Region site:USA/Redmond

예제 5에 표시된 명령은 USA 사이트(즉 SiteId가 site:USA인 사이트)로 범위가 지정된 Redmond 지역에 대한 전화 접속 회의 액세스 번호를 모두 반환합니다.

-------------------------- 예제 6 ------------------------

Get-CsDialInConferencingAccessNumber -Filter {DisplayName -like "*Seattle*"}

예제 6에서는 Filter 매개 변수를 사용하여 DisplayName에 "Seattle"이라는 문자열 값이 포함된 모든 전화 접속 회의 액세스 번호의 컬렉션을 반환합니다. 필터 값 {DisplayName -like "*Seattle*"}은 반환되는 데이터를 DisplayName에 "Seattle"이라는 단어가 포함된 액세스 번호(예: Seattle Access Number, Dial-In Number for Seattle, Tacoma/Seattle Access Number 등)로 제한합니다.

-------------------------- 예제 7 ------------------------

Get-CsDialInConferencingAccessNumber -Filter {LineUri -like "tel:+1425*"}

예제 7에서는 회선 URI가 +1425로 시작하는 모든 전화 접속 회의 액세스 번호를 반환합니다. 따라서 미국 지역 번호가 425인 모든 액세스 번호가 효과적으로 반환됩니다. 이 작업을 수행하기 위해 Filter 매개 변수와 함께 Get-CsDialInConferencingAccessNumber가 호출됩니다. 필터 값 {LineUri -like "tel:+1425*"}는 반환되는 데이터를 문자열 값 "tel:+1425"로 시작하는 줄 URI로 제한합니다. 지역 번호가 425인 전화 번호나 지역 번호가 206인 전화 번호를 모두 반환하려면 다음 필터 값을 사용합니다.

{LineUri -like "tel:+1425*" -or LineUri -like "tel:+1206*"}

-------------------------- 예제 8 ------------------------

Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -eq "it-IT"}

위의 예제는 기본 언어가 이탈리아어로 설정된 모든 전화 접속 회의 액세스 번호의 컬렉션을 반환합니다. 이 작업을 수행하기 위해 먼저 Get-CsDialInConferencingAccessNumber를 호출하여 조직에서 사용하도록 구성된 모든 액세스 번호의 컬렉션을 반환합니다. 이 컬렉션은 PrimaryLanguage 속성이 Italian("it-It")과 같은 번호만 선택하는 Where-Object cmdlet에 파이프됩니다.

-------------------------- 예제 9 --------------------------

Get-CsDialInConferencingAccessNumber  | Where-Object {$_.SecondaryLanguages -contains "fr-FR"}

예제 9에 표시된 명령은 보조 언어 중 하나로 프랑스어가 나열된 모든 전화 접속 회의 액세스 번호를 반환합니다. 이 작업을 수행하기 위해 먼저 매개 변수 없이 Get-CsDialInConferencingAccessNumber를 호출하여 조직에서 사용하도록 구성된 모든 액세스 번호의 컬렉션을 반환합니다. 이 컬렉션은 SecondaryLanguages 속성에 French(fr-FR) 목록이 포함된 번호만 선택하는 Where-Object cmdlet에 파이프됩니다.

참고 항목

기타 리소스

New-CsDialInConferencingAccessNumber
Remove-CsDialInConferencingAccessNumber
Set-CsDialInConferencingAccessNumber