Get-CsUser

구문

Get-CsUser [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OnLyncServer <SwitchParameter>] [-OnOfficeCommunicationServer <SwitchParameter>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-UnAssignedUser <SwitchParameter>]

자세한 정보

Get-CsAdUser 및 Get-CsUser cmdlet을 함께 사용하면 모든 Active Directory 사용자 계정에 대한 자세한 정보를 가져올 수 있습니다. Get-CsAdUser는 Lync Server 2010 또는 Office Communications Server를 사용할 수 있는 사용자와 Lync Server 또는 Office Communications Server를 사용할 수 없는 사용자를 포함하여 모든 사용자 계정에 대한 정보를 반환합니다. 이 cmdlet은 Lync Server 또는 Office Communications Server를 사용할 수 있는 계정의 사용자에 대한 정보만 반환하는 Get-CsUser와 다릅니다.

두 cmdlet 사이에 서로 겹치는 부분은 있지만 Get-CsUser와 Get-CsAdUser는 반환하는 정보의 유형이 다릅니다. 일반적으로 Get-CsUser는 특히 Lync Server에 관련된 Active Directory 특성 값을 반환합니다. 예를 들어 Get-CsUser는 사용자에게 할당된 Lync Server 정책, 사용자에게 할당된 URI(Uniform Resource Identifier) 행, 사용자가 Enterprise Voice를 사용할 수 있는지 여부에 대한 세부 정보 등의 정보를 반환합니다. Lync Server에 대해 사용자가 활성화되지 않은 경우 이러한 특성은 사용자 계정의 일부가 아닙니다.

반면, Get-CsAdUser는 기본 Active Directory 사용자 계정의 일부이며 사용자가 Lync Server를 사용할 수 있는지 여부에 관계없이 존재하는 특성인 제네릭 Active Directory 특성 값을 반환합니다. 예를 들어 Get-CsAdUser는 사용자가 근무하는 부서 및 조직, 직함, 전화 번호, 사무실 주소 등의 사용자 정보를 반환합니다.

Get-CsUser가 반환하는 특성 값의 전체 목록을 보려면 Windows PowerShell 명령 프롬프트에서

Get-CsUser | Get-Member 명령을 입력합니다.

Get-CsUser를 통해 cmdlet을 실행할 때 실제로 반환되는 사용자 컬렉션을 필터링할 수 있습니다. 예를 들어 Lync Server 사용자 계정을 모두 반환하지 않으려면 선택적 매개 변수인 Filter 또는 LDAPFilter를 적용할 수 있습니다. 두 매개 변수는 함께 사용할 수 없습니다. 명령에서 Filter를 사용하는 경우 동일한 명령에서 LDAPFilter는 사용할 수 없으며 그 반대의 경우도 마찬가지입니다. Filter 매개 변수를 사용하면 지정한 Lync Server 조건을 충족하는 사용자에 대한 데이터만 반환되도록 제한할 수 있습니다. 예를 들어 지정한 등록자 풀에 계정이 있는 사용자만 반환하거나 Enterprise Voice를 사용할 수 있는 사용자만 반환할 수 있습니다. LDAPFilter 매개 변수를 사용하면 다른 Active Directory 기반 조건에 적합한 사용자에 대한 데이터만 반환하도록 제한할 수 있습니다. 예를 들어 지정한 주 또는 시/도에서 일하는 사용자, 호출기가 있거나 없는 사용자, 지정한 직위를 가진 사용자 등입니다.

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

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUser\b"}

매개 변수

입력 형식

문자열. Get-CsUser는 Lync Server 2010를 사용하도록 설정된 사용자 계정의 ID를 나타내는 파이프라인된 문자열 값을 허용합니다.

반환 형식

Get-CsUser는 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 개체의 인스턴스를 반환합니다.

예제

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

Get-CsUser

위 예제에서는 Lync Server 또는 Office Communications Server를 사용할 수 있는 모든 도메인 사용자 컬렉션을 반환하기 위해 매개 변수 없이 Get-CsUser를 호출합니다.

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

Get-CsUser | Format-Table -Property DisplayName, SipAddress, EnterpriseVoiceEnabled -AutoSize

예제 2에서는 Get-CsUser를 사용하여 Lync Server 또는 Office Communications Server를 사용할 수 있는 모든 도메인 사용자 컬렉션을 반환합니다. 기본적으로 Get-CsUser는 많은 속성 및 속성 값을 반환하며, 이 중 대부분은 지정된 상황에 그다지 관계가 없습니다. 따라서 이 예제에서는 검색된 데이터가 Format-Table cmdlet에 파이프됩니다. Format-Table은 Property 매개 변수를 사용하여 DisplayName, SipAddress 및 EnterpriseVoiceEnabled 속성을 선택하고 이러한 속성과 해당 값을 테이블에 표시합니다.

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

Get-CsUser -Identity "Pilar Ackerman"

예제 3에서는 Identity 매개 변수를 사용하여 Identity(이 경우 표시 이름)가 Pilar Ackerman인 사용자 계정에 대한 데이터만 반환되도록 제한합니다.

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

Get-CsUser -Identity "Pilar*"

예제 4에서는 사용자 ID를 지정할 때 와일드카드 문자(*)가 사용됩니다. 이 경우 Get-CsUser는 ID가 문자열 값 "Pilar"로 시작하는 모든 사용자를 반환합니다.

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

Get-CsUser -Filter {VoicePolicy -eq $Null}

예제 5에 표시된 명령은 사용자별 음성 정책이 할당되어 있지 않은 사용자 컬렉션을 반환합니다. 이 작업을 수행하기 위해 Filter 매개 변수 뒤에 VoicePolicy -eq "$Null 필터를 사용합니다. Get-CsUser에 사용할 필터를 작성할 때 속성 이름(VoicePolicy) 뒤에 비교 연산자(이 경우 "같지 않음"을 의미하는 비교 연산자 "eq")를 지정해야 합니다. 비교 연산자 바로 뒤에는 테스트할 값이 옵니다. 이 예제에서는 null 값을 나타내는 Windows PowerShell 변수인 $Null을 사용합니다.

음성 정책이 할당되지 않은 사용자 컬렉션을 반환하려면 다음 명령을 사용합니다.

Get-CsUser -Filter {VoicePolicy -ne $Null}

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

Get-CsUser -LDAPFilter "Department=Finance"

위 명령은 LDAPFilter 매개 변수를 사용하여 Finance 부서에서 근무하는 사용자에 대한 데이터만 반환되도록 제한합니다. 이 작업은 LDAP 필터 값 "Department=Finance"를 사용하여 수행합니다.

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

Get-CsUser -LDAPFilter "&(Department=Finance)(Title=Manager)"

예제 7에서는 LDAPFilter 매개 변수와 함께 AND 쿼리를 사용하는 방법을 보여 줍니다. 앰퍼샌드 문자 "&"를 사용하여 AND 쿼리를 표시하는 이 쿼리는 "Department=Finance" 및 "Title=Manager"의 두 조건을 지정합니다. 이 쿼리에서 반환될 사용자 계정은 사용자가 Finance 부서에서 근무하고 Manager여야 한다는 두 조건이 모두 true여야 합니다.

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

Get-CsUser -LdapFilter "|(Title=Supervisor)(Title=Manager)"

예제 8에 표시된 명령에서는 LDAPFilter 매개 변수와 함께 OR 쿼리(파이프 기호 "|"로 표시됨)가 사용됩니다. 예제 7에 표시된 AND 쿼리에서는 사용자 계정이 반환되기 위해 두 조건이 모두 true여야 했습니다. OR 쿼리에서는 계정이 반환되기 위해 한 조건만 true이면 됩니다. 이 경우 사용자가 Supervisor인 경우 또는 사용자가 Manager인 경우이면 사용자 계정이 반환됩니다.

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

Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com"

예제 9에서는 Finance OU에 계정이 있는 모든 사용자에 대한 사용자 계정 정보를 반환합니다.

-------------------------- 예제 10 --------------------------

Get-CsUser -UnassignedUser

위 명령은 Lync Server 또는 Office Communications Server를 사용할 수 있지만 현재 등록자 풀에 할당되어 있지 않은 모든 사용자 컬렉션을 반환합니다.

참고 항목

기타 리소스

Disable-CsUser
Enable-CsUser
Get-CsAdUser
Move-CsUser
Set-CsUser