Get-CsUser

 

마지막으로 수정된 항목: 2017-03-15

비즈니스용 Skype 서버 2015 또는 이전 버전의 소프트웨어를 사용할 수 있는 조직 내 모든 사용자에 대한 정보를 반환합니다. 이 cmdlet은 Lync Server 2010에서 도입되었습니다.

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

위 예제에서는 비즈니스용 Skype 서버 2015를 사용할 수 있는 모든 도메인 사용자 컬렉션을 반환하기 위해 매개 변수 없이 Get-CsUser cmdlet을 호출합니다.

Get-CsUser

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

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

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

Get-CsUser -Identity "Pilar Ackerman"

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

Get-CsUser -Identity "Pilar*"

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

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

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

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

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

Get-CsUser -LdapFilter "Department=Finance"

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

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

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

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

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

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

예제 10에서는 비즈니스용 Skype 서버 2015를 사용할 수 있지만 현재 등록자 풀에 할당되어 있지 않은 모든 사용자 컬렉션을 반환합니다.

Get-CsUser -UnassignedUser

Get-CsAdUser cmdlet과 Get-CsUser cmdlet을 함께 사용하면 모든 Active Directory 사용자 계정에 대한 자세한 정보를 반환할 수 있습니다. Get-CsAdUser cmdlet은 비즈니스용 Skype 서버 2015를 사용할 수 있는 사용자와 비즈니스용 Skype 서버 2015를 사용할 수 없는 사용자를 포함하여 모든 사용자 계정에 대한 정보를 반환합니다. 이 cmdlet은 비즈니스용 Skype 서버 2015를 사용할 수 있는 계정의 사용자에 대한 정보만 반환하는 Get-CsUser cmdlet과 다릅니다.

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

반면, Get-CsAdUser cmdlet은 기본 Active Directory 사용자 계정의 일부이며 사용자가 비즈니스용 Skype 서버 2015를 사용할 수 있는지 여부에 관계없이 존재하는 특성인 일반 Active Directory 특성 값을 반환합니다. 예를 들어 Get-CsAdUser cmdlet은 사용자의 직함, 전화 번호, 사무실 주소뿐 아니라 사용자가 근무하는 부서 및 조직 등의 정보도 반환합니다.

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

Get-CsUser | Get-Member

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

 

매개 변수 필수 유형 설명

Credential

선택

System.Management.Automation.PSCredential

대체 자격 증명으로 Get-CsUser cmdlet을 실행할 수 있습니다. Windows에 로그온할 때 사용한 계정에 사용자 개체 작업에 필요한 권한이 없는 경우 이 매개 변수가 필요할 수 있습니다.

Credential 매개 변수를 사용하려면 먼저 Get-Credential cmdlet을 사용하여 PSCredential 개체를 만들어야 합니다. 자세한 내용은 Get-Credential cmdlet 도움말 항목을 참조하세요.

DomainController

선택

Microsoft.Rtc.Management.Deploy.Fqdn

사용자 정보를 검색하기 위해 지정한 도메인 컨트롤러에 연결할 수 있습니다. 특정 도메인 컨트롤러에 연결하려면 DomainController 매개 변수 뒤에 FQDN(정규화된 도메인 이름)을 포함합니다(예: atl-cs-001.litwareinc.com).

Filter

선택

System.String

비즈니스용 Skype 서버 2015 관련 특성을 필터링하여 반환된 데이터를 제한할 수 있습니다. 예를 들어, 특정 음성 정책이 할당된 사용자 또는 특정 음성 정책이 할당되지 않은 사용자에 대한 데이터만 반환하도록 제한할 수 있습니다.

Filter 매개 변수는 Where-Object cmdlet에 사용되는 구문과 동일한 Windows PowerShell 필터링 구문을 사용합니다. 예를 들어 Enterprise Voice를 사용하도록 설정된 사용자만 반환하는 필터는 다음과 유사한 형태입니다. 여기서 EnterpriseVoiceEnabled는 Active Directory 특성을 나타내고 -eq는 비교 연산자(같음)를 나타내며 $True(기본 제공 Windows PowerShell 변수)는 필터 값을 나타냅니다.

{EnterpriseVoiceEnabled -eq $True}

Identity

선택

Microsoft.Rtc.Management.AD.UserIdParameter

검색할 사용자 계정의 ID를 나타냅니다. 사용자 ID는 네 가지 형식 중 하나를 사용하여 지정할 수 있는데, 이러한 형식은 1) 사용자의 SIP 주소, 2) 사용자의 UPN(사용자 계정 이름), 3) 도메인\로그온 형태인 사용자의 도메인 이름 및 로그온 이름(예: litwareinc\kenmyer) 및 4) 사용자의 Active Directory 표시 이름(예: Ken Myer)입니다. 또한 사용자의 Active Directory 고유 이름을 사용하여 사용자 계정을 참조할 수도 있습니다.

표시 이름을 사용자 ID로 사용할 경우 별표(*) 와일드카드 문자를 사용할 수 있습니다. 예를 들어 ID "* Smith"는 문자열 값 "Smith"로 끝나는 표시 이름을 가진 모든 사용자를 반환합니다.

LdapFilter

선택

System.String

일반 Active Directory 특성(즉, 비즈니스용 Skype 서버 2015와 관련되지 않은 특성)을 필터링하여 반환되는 데이터를 제한할 수 있습니다. 예를 들어 특정 부서에서 일하는 사용자나 지정된 관리자 또는 직위를 가진 사용자에 대한 데이터만 반환하도록 제한할 수 있습니다.

필터를 만들 때 LdapFilter 매개 변수는 LDAP 쿼리 언어를 사용합니다. 예를 들어, Redmond 도시에 일하는 사용자만 반환하는 필터는 "l"(소문자 L)을 사용하여 "l=Redmond"와 같이 나타납니다. 여기서 "l"는 Active Directory 특성(구/군/시)을 나타내고 "="는 비교 연산자(같음)를 나타내며 "Redmond"는 필터 값을 나타냅니다.

OnModernServer

선택

System.Management.Automation.SwitchParameter

PARAMVALUE: SwitchParameter

OnOfficeCommunicationServer

선택

System.Management.Automation.SwitchParameter

Office Communications Server 2007에 있는 사용자 컬렉션을 반환합니다. 이 매개 변수를 사용하는 경우 현재 버전의 소프트웨어에 계정이 있는 사용자는 반환되지 않습니다.

OU

선택

Microsoft.Rtc.Management.AD.OUIdParameter

특정 OU(조직 구성 단위) 또는 컨테이너의 사용자 계정에 대한 정보를 반환하는 데 사용됩니다. OU 매개 변수는 지정한 OU 및 모든 하위 OU의 데이터를 반환합니다. 예를 들어 Finance OU에 두 개의 하위 OU인 AccountsPayable 및 AccountsReceivable이 있는 경우 이러한 세 개의 각 OU에서 사용자가 반환됩니다.

OU를 지정할 때는 해당 컨테이너에 대한 DN(고유 이름)을 사용합니다(예: -OU "OU=Finance,dc=litwareinc,dc=com"). Users 컨테이너에서 사용자 계정을 가져오려면 다음 구문을 사용합니다.

-OU "cn=Users,dc=litwareinc,dc=com"

ResultSize

선택

Microsoft.Rtc.Management.ADConnect.Core.Unlimited

cmdlet에서 반환되는 레코드 수를 제한하는 데 사용됩니다. 예를 들어 포리스트에 있는 사용자 수에 상관없이 7명의 사용자만 반환하려면 ResultSize 매개 변수를 포함하고 매개 변수 값을 7로 설정합니다. 반환될 7명의 사용자를 지정하는 방법은 없습니다.

결과 크기는 0-2147483647(포함) 사이의 임의 정수로 설정할 수 있습니다. 0으로 설정할 경우 명령이 실행되지만 데이터가 반환되지 않습니다. ResultSize를 7로 설정했지만 포리스트에 사용자가 3명만 있는 경우 3명의 사용자가 반환된 다음, 오류 없이 완료됩니다.

UnassignedUser

선택

System.Management.Automation.SwitchParameter

비즈니스용 Skype 서버 2015에 대해 활성화되었지만 현재 등록자 풀에 할당되어 있지 않은 모든 사용자 컬렉션을 반환할 수 있습니다. 등록자 풀에 할당되지 않은 사용자는 비즈니스용 Skype 서버 2015에 로그온할 수 없습니다.

문자열. Get-CsUser cmdlet은 비즈니스용 Skype 서버 2015를 사용하도록 설정된 사용자 계정의 ID를 나타내는 파이프라인된 문자열 값을 허용합니다.

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

 
표시: