Get-CsAdForest
마지막으로 수정된 항목: 2012-03-23
Active Directory 포리스트가 Microsoft Lync Server 2010을 설치할 수 있도록 올바르게 구성되었는지 여부를 나타내는 정보를 반환합니다.
구문
Get-CsAdForest [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-RootDomainController <Fqdn>] [-SkipPrepareCheck <$true | $false>]
자세한 정보
Lync Server 2010을 설치하려면 AD DS(Active Directory 도메인 서비스)에서 몇 가지 포리스트 수준을 변경해야 합니다. 여기에는 Lync Server 관련 표시 지정자 및 개체를 만들고, Lync Server를 관리하는 데 필요한 유니버설 보안 그룹을 만들고, 글로벌 설정 개체에 이러한 그룹에 대한 액세스 권한을 부여하는 과정이 포함됩니다. Get-CsAdForest cmdlet은 포리스트에 Lync Server를 설치할 수 있는지 여부를 나타내는 단일 값을 반환합니다. Get-CsAdForest가 LC_FORESTSETTINGS_STATE_READY 값을 반환하는 경우 Lync Server를 포리스트에 설치할 수 있습니다. cmdlet이 LC_FORESTSETTINGS_STATE_NOT_READY를 반환하는 경우 Lync Server를 설치하려고 시도하기 전에 도메인을 올바르게 준비해야 합니다.
Get-CsAdForest는 설치 마법사의 일부로 실행됩니다. 마법사에서 해당 포리스트가 올바르게 준비되지 않았다고 판단한 경우 오류 메시지가 나타나고 설치가 중지됩니다. 그러나 Lync Server 설치를 시도하기 전에 설치 마법사와는 별도로 Get-CsAdForest를 실행하여 포리스트 상태를 확인할 수 있습니다.
Get-CsAdForest는 다음 Microsoft Office Communications Server 2007 R2 명령과 동일한 기능을 수행합니다.
Lcscmd.exe /forest /action:CheckForestPrepState
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 Active Directory에 대한 읽기 권한을 가진 사용자는 누구나 Get-CsAdForest cmdlet을 로컬로 실행할 수 있습니다. 일반적으로 모든 도메인 구성원은 이 권한이 있습니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAdForest"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
GlobalCatalog |
선택 |
문자열 |
도메인에 있는 글로벌 카탈로그 서버의 FQDN(정규화된 도메인 이름)입니다. 사용자 도메인 계정을 가진 컴퓨터에서 Get-CsAdForest를 실행하는 경우 이 매개 변수가 필요하지 않습니다. |
GlobalSettingsDomainController |
선택 |
문자열 |
글로벌 설정이 저장된 도메인 컨트롤러의 FQDN입니다. 글로벌 설정이 AD DS의 시스템 컨테이너에 저장된 경우 이 매개 변수는 루트 도메인 컨트롤러를 가리켜야 합니다. 글로벌 설정이 구성 컨테이너에 저장된 경우 아무 도메인 컨트롤러나 사용할 수 있으며 이 매개 변수는 생략해도 됩니다. |
RootDomainController |
선택 |
문자열 |
외부 도메인의 리소스에 액세스해야 하는 클라이언트를 위해 신뢰 경로를 만드는 데 사용되는 루트 도메인 컨트롤러의 FQDN입니다. |
Report |
선택 |
문자열 |
cmdlet이 실행될 때 만들어지는 로그 파일의 파일 경로를 지정하는 데 사용됩니다(예: -Report "C:\Logs\ForestPrep.html"). |
SkipPrepareCheck |
선택 |
부울 |
True($True)로 설정하면 Get-CsAdForest가 초기 준비 검사를 수행하지 않고 실행됩니다. |
입력 형식
없음.
반환 형식
Get-CsAdForest는 Microsoft.Rtc.Management.Deployment.LcForestSettingsState 개체의 인스턴스를 반환합니다.
예제
-------------------------- 예제 1 --------------------------
Get-CsAdForest
위의 예제에서는 Active Directory 포리스트가 Lync Server를 설치할 수 있도록 올바르게 구성되었는지 여부를 나타내는 정보를 반환합니다.
-------------------------- 예제 2 --------------------------
Get-CsAdForest -Report C:\Logs\ForestState.html
예제 2에서는 포리스트 상태 정보를 반환하고 포리스트 준비 상태를 화면에 표시합니다. 또한 포리스트 상태를 확인하기 위해 수행해야 하는 단계에 대한 자세한 정보를 C:\Logs\ForestState.html이라는 파일에 기록합니다. 이 파일은 권한이 확인된 모든 Active Directory 그룹 및 Active Directory 컨테이너의 자세한 목록 등을 포함합니다.