일반 CSV 커넥터 - 기술 참조 가이드(미리 보기)

아티클
03/30/2024

이 문서에서는 GCSV(일반 CSV) 커넥터에 대해 설명합니다. 이 문서는 다음 제품에 적용됩니다.

MIM 2016의 경우 커넥터는 Microsoft 다운로드 센터에서 다운로드할 수 있습니다.

작업에서 이 커넥터를 보려면 Generic SQL Connector step-by-step(일반 SQL 커넥터 단계별) 문서를 참조하세요.

참고

이제 Azure AD 프로비저닝 서비스는 전체 MIM 동기화 배포 없이 사용자를 CSV 파일로 프로비전하기 위한 간단한 에이전트 기반 솔루션을 제공합니다. 요구 사항을 충족하는지 평가하는 것이 좋습니다. 자세히 알아보세요.

일반 CSV 커넥터 개요

GCSV(일반 CSV) 커넥터를 사용하면 CSV 파일에서 유지 관리되는 사용자 및 그룹 ID 데이터를 ECMA2Host(Microsoft Entra Connect Provisioning Agent) 및 Microsoft Identity Manager 2016(MIM2016)과 같은 Microsoft 제품과 통합할 수 있습니다.

PowerShell을 사용하여 가져오기 전이나 후에 ID 데이터를 관리하거나 내보내는 작업을 오케스트레이션하는 기능과 같은 다양한 기능이 있습니다. 이진 및 참조, 정규화된 문자열 값 및 다중값 문자열을 비롯한 여러 데이터 형식에 대한 지원을 제공합니다.

이 문서에서는 일반 CSV 커넥터의 기능 및 MIM 2016용으로 구성하는 방법을 설명합니다.

다음 표에서는 고급 관점에서 커넥터의 현재 릴리스에서 지원하는 기능을 나열합니다.

기능	세부 정보
여러 제품 지원	이 커넥터의 사용은 다음 Microsoft 제품에서 지원됩니다. Microsoft Entra Connect 프로비저닝 에이전트(ECMA2Host) Microsoft Identity Manager 2016 (MIM2016)
지원되는 CSV 파일	이 커넥터는 최대 3개의 CSV 파일 구성을 통해 사용자(필수) 및 그룹(선택 사항)의 관리를 지원합니다. 사용자 CSV 파일(예: Users.csv) 그룹 CSV 파일(예: Groups.csv) 그룹 구성원 CSV 파일(예: Members.csv)
PowerShell을 사용하여 작업 전/후 처리	이 커넥터는 가져오기 또는 내보내기 전후에 사용자 및 그룹 ID 데이터의 사전 또는 사후 처리를 용이하게 하기 위해 최대 4개의 PowerShell 스크립트 구성을 지원합니다.
CSV 파일 인코딩 지원	커넥터는 모든 기본(또는 설치된) 서버 인코딩 형식(예: 유니코드, UTF-8, UTF-7, ASCII 등)을 지원합니다.
지원되는 CSV 필드 데이터 형식	커넥터는 다음 특성 데이터 형식을 지원합니다. Binary – (base64 문자열로) 부울 – (True/False) 정수 문자열/다중값 문자열 참조
CSV 필드 구분	문자열 값의 시작과 끝을 한정하기 위해 쉼표(,) 또는 인쇄 가능한 영숫자 문자를 지원합니다.
문자열 자격 지원	문자열 값의 시작과 끝을 한정하기 위해 큰따옴표(") 또는 인쇄 가능한 영숫자 문자를 지원합니다.
다중값 문자열 지원	다중값 문자열 지원
지원되는 커넥터 작업	커넥터는 다음 작업을 지원합니다. 전체 가져오기 내보내기 전체 내보내기
스키마	스키마 검색은 동적이지만 완료하려면 수동 구성이 필요합니다. 필드는 지정된 구분 기호(또는 "값 구분 기호")를 기반으로 동적으로 식별됩니다. 필드 데이터 형식은 구성 중에 수동으로 지정됩니다.

사전 요구 사항

커넥터를 사용하기 전에 동기화 서버에 다음이 있는지 확인합니다.

Microsoft .NET 4.6.2 프레임워크 이상
다음 ID 형식에 대해 원하는 스키마를 포함하는 CSV 파일:
- 사용자 파일(필수)
- 그룹(선택 사항)
- 그룹 구성원(그룹을 사용하는 경우 필요)
(선택 사항) 다음 작업 유형 이벤트에 대한 사전 및 사후 처리를 관리하는 PowerShell 스크립트:
- 가져오기 전 – 가져오기 작업이 실행되기 전에 이 스크립트가 실행됩니다.
- 가져오기 후 – 이 스크립트는 가져오기 작업을 실행한 후에 실행됩니다.
- 내보내기 전 – 이 스크립트는 내보내기 작업이 실행되기 전에 실행됩니다.
- 내보내기 후 – 이 스크립트는 내보내기 작업을 실행한 후에 실행됩니다.

MIM 동기화 서비스 계정 권한

중요

MIM 2016 동기화 서비스 계정은 CSV 파일에 대한 파일 작업을 수행하고 전/후 처리 PowerShell 스크립트를 실행하는 보안 컨텍스트입니다. 이 서비스 계정에는 구성된 모든 CSV 및 PowerShell 파일에 대한 읽기/쓰기 권한이 필요합니다. 또한 구성된 스크립트를 실행하려면 적절한 PowerShell ExecutePolicy 권한이 필요합니다.

새 커넥터 만들기

다음 목록은 이 가이드에 설명된 단계에 대한 개략적인 개요입니다. 시작하려면 MIM 동기화 관리 역할이 있는 계정을 사용하여 다음 작업을 수행해야 합니다.

MIM 동기화 Service ManagerMA(새 관리 에이전트) 만들기 창을 엽니다.
커넥터 유형으로 일반 CSV 커넥터 를 선택합니다.
가져오거나 내보낼 CSV 파일의 파일 경로와 이름을 제공합니다.
CSV 파일에 대한 파일 인코딩, 값 구분 기호, 다중 값 구분 기호 및 텍스트 한정자를 지정합니다.
첫 번째 행의 값을 머리글 필드로 사용할지 여부를 선택합니다.
CSV 파일에서 가져오거나 내보낼 개체 유형 및 특성을 선택합니다.
MA에 대한 파티션, 실행 프로필 및 매핑 세부 정보를 구성합니다.
PowerShell 스크립트에 대한 스크립트 경로 및 매개 변수(있는 경우)를 제공합니다.
MA를 실행하여 가져오기, 동기화 또는 내보내기 작업을 수행합니다.

일반 CSV 커넥터를 만들려면 동기화 서비스에서관리 에이전트 및 만들기를 선택합니다. 일반 CSV(Microsoft) 커넥터를 선택합니다.

커넥터 만들기 페이지 1의 스크린샷

연결

연결 페이지에는 사용자, 그룹 및 그룹 구성원 CSV 파일의 파일 위치가 포함되어 있습니다.

다음 이미지는 연결 페이지의 예 입니다 .

연결 페이지의 스크린샷

다음 CSV 파일의 위치는 이 페이지에 지정됩니다.

사용자 파일: 사용자 레코드 및 해당 특성 값이 포함된 CSV 파일의 정규화된 경로입니다. 해당 파일이 필요합니다.
그룹 파일: 그룹 레코드를 포함하는 CSV 파일의 정규화된 경로입니다. 이 파일은 선택 사항입니다.
멤버 파일: 그룹 멤버 참조 레코드가 포함된 CSV 파일의 정규화된 경로입니다.

중요

MIM 동기화 서비스 계정에는 지정된 모든 CSV 파일에 대한 읽기 및 쓰기 권한이 있어야 합니다. 앞에서 설명한 것처럼 사용자만 구성된 경우에는 그룹 및 멤버 파일이 필요하지 않습니다.

연결 화면은 새 일반 SQL 커넥터를 만들 때의 첫 번째 화면입니다. 먼저 다음 섹션 정보를 제공해야 합니다.

기능

이 페이지에서는 커넥터의 기능을 설명합니다. 커넥터 기능은 고정되어 있으며 변경할 수 없지만 커넥터 작동 방식에 대한 정보를 제공하기 위해 여기에 설명되어 있습니다.

다음 이미지는 기능 페이지의 예입니다.

Capablities 페이지의 스크린샷

다음 섹션에서는 개별 구성 및 해당 의미를 나열합니다.

LDAP(고유 이름 스타일): GCSV 커넥터는 LDAP(Lightweight Directory Access Protocol) 구문을 사용하여 DN(고유 이름)을 생성하여 커넥터 공간에서 각 User 또는 Group 개체를 고유하게 식별합니다. 모든 DN 값은 CN=[ANCHOR_VALUE],Object=[User| 형식으로 표현됩니다.Group],O=CSV.
개체 확인(기본): 일반적으로 동기화 엔진은 내보내기 후 후속 델타 가져오기에서 개체를 다시 검색할 수 있다고 가정합니다. 이는 동기화 엔진이 일반적으로 작동하는 방식이지만 모든 연결된 시스템이 이러한 방식으로 작동하는 것은 아닙니다. 이 기본 설정은 후속 가져오기에 경고가 없 exported-change-not-reimported 도록 합니다.
내보내기 유형(MultivaluedReferenceAttributeUpdate) : 내보내기 유형은 동기화 중에 개체의 서식을 지정하고 대상 시스템으로 보내는 방법을 지정합니다. MultivaluedReferenceAttributeUpdate는 Microsoft Entra ID 사용하도록 설계된 내보내기 유형입니다. 변경된 특성만 보냅니다. 값 형식 특성의 경우 AttributeReplace를 사용하고 참조 특성에는 AttributeUpdate를 사용합니다.
정규화(없음): 정규화는 데이터를 일관된 형식으로 표준화하는 것을 의미합니다. 없음은 특정 정규화 규칙이 적용되지 않음을 의미합니다. 데이터는 커넥터에서 추가 변환 없이 그대로 유지됩니다.

스키마 1(CSV 파일 형식 구성)

GCSV 커넥터는 세 종류의 구분 기호(또는 구분 기호)를 사용하여 CSV 필드와 해당 값을 구분하고 구문 분석합니다.

이 페이지에는 이러한 구분 기호에 대한 문자 값 설정과 파일을 CSV로 만드는 데 사용된 인코딩 형식이 포함되어 있습니다.

다음 이미지는 스키마 1(CSV 파일 형식 구성) 페이지의 이미지입니다.

동기화 규칙 페이지 4(CSV 파일 형식 구성)의 스크린샷

다음 섹션은 개별 구성 목록입니다.

스키마 검색에 헤더 사용: 이 옵션을 선택하면 커넥터에 각 CSV 파일의 첫 번째 레코드를 ID 데이터 레코드가 아닌 헤더 레코드로 처리하도록 지시합니다. 이 옵션을 선택하지 않으면 커넥터는 고유 증분 정수 값(예: Attribute1, Attribute2 등)이 추가된 특성이라는 이름을 할당하고 의 첫 번째 행을 ID 데이터 레코드로 처리합니다.
값 구분 기호: 이 문자는 CSV 레코드의 필드(즉, 값)를 구분합니다. 쉼표(,)는 기본값이지만 인쇄할 수 있는 영숫자 문자는 허용됩니다.
다중값 구분 기호: 이 형식의 구분 기호는 다중값 문자열(예: 프록시 주소) 또는 참조 특성(예: 하위 항목)의 개별 값을 구분하는 데 사용됩니다. 기본값은 세미콜론(;)이지만 인쇄 가능한 영숫자 문자는 허용됩니다.
텍스트 한정자: 문자열 값에 구분 기호로 해석되는 문자(예: 쉼표)가 포함된 경우 CSV 파서가 문자열을 단일 필드로 올바르게 해석할 수 있도록 값을 정규화해야 합니다. 큰따옴표(")는 기본값이지만 인쇄할 수 있는 영숫자 문자는 모두 허용됩니다.

참고

CSV 파일의 스키마에는 다중값 필드가 포함되지 않거나 문자열 정규화가 필요한 값이 포함되지 않을 수 있지만 각 구분 기호 형식에 대해 고유한 인쇄 가능한 문자를 지정해야 합니다.

파일 인코딩: 이 설정은 연결 탭에 추가된 CSV 파일에 사용되는 인코딩을 나타냅니다. CSV 파일의 인코딩과 일치하는지 확인합니다.

참고

CSV 파일의 인코딩 형식을 잘 모르는 경우 기본 유니코드 인코딩 형식을 사용해야 합니다. 유니코드는 많은 문자와 기호를 지원하는 일반적인 표준이므로 대부분의 언어 또는 문자 집합에서 텍스트 데이터를 인코딩하는 데 적합합니다.

스키마 2(ID 및 참조 필드 구성)

앵커 값은 CSV 파일의 레코드에 대한 고유 식별자입니다. 하나의 레코드를 다른 레코드와 구분합니다. GCSV 커넥터는 이 값을 사용하여 관련 커넥터 공간 개체를 식별하는 DN(고유 이름)을 만듭니다.

이 페이지에서 앵커 특성 설정은 연결 페이지에 나열된 각 CSV 파일에 대해 설정됩니다.

다음 이미지는 스키마 2(ID 및 참조 필드 구성) 페이지의 예입니다.

스키마 2(ID 및 참조 필드 구성) 페이지의 스크린샷

다음 섹션은 이 페이지의 개별 구성 목록입니다.

사용자
- 사용자 앵커: 사용자 레코드의 앵커 값 역할을 하는 사용자 파일의 필드입니다. 사용자 파일의 첫 번째 헤더 필드가 기본 선택 항목입니다.
- User Anchor 특성 유형: 선택한 앵커의 특성 유형입니다.
그룹
- 그룹 앵커: 그룹 레코드의 앵커 값 역할을 하는 그룹 파일의 필드입니다. 그룹 파일의 첫 번째 헤더 필드가 기본 선택 항목입니다.
- Group Anchor 특성 유형: 선택한 앵커의 특성 유형입니다.
멤버
- 부모 그룹 ID: 그룹 CSV 파일의 부모 그룹과 동일한(앵커) 값을 포함하는 멤버 파일의 필드입니다. 멤버 파일의 첫 번째 필드는 기본적으로 사용됩니다.
- 멤버 ID: 사용자 또는 그룹 CSV 파일과 동일한(앵커) 값을 포함하는 멤버 파일의 필드입니다. 멤버 파일의 두 번째 필드는 기본적으로 선택됩니다.
멤버 개체 형식: 멤버의 개체 형식을 나타내는 "User" 또는 "Group" 문자열 값이 들어 있는 필드입니다. 이 필드는 멤버 파일에 두 개 이상의 필드가 포함된 경우에만 필요합니다. 개체 형식 필드에는 문자열 값 "User" 또는 "Group"만 포함되어야 합니다. 이 필드가 없으면 커넥터는 멤버 파일 레코드가 User 개체 멤버를 참조한다고 가정합니다. 멤버 파일에 있는 세 번째 필드는 기본적으로 선택되어 있습니다.

중요

앵커로 사용하도록 지정된 특성의 이름은 모든 개체 형식 스키마에서 고유해야 합니다. 여기에는 그룹 구성원 파일에 지정된 앵커가 포함됩니다.

스키마 3(사용자 파일 특성 스키마 구성)

이 페이지는 사용자 CSV 파일의 스키마에서 식별되는 각 필드의 데이터 형식과 둘 이상의 값을 가질 수 있는지 여부를 지정하고 설명하기 위한 것입니다.

다음 이미지는 스키마 3(사용자 파일 특성 스키마 구성) 페이지의 예입니다.

스키마 3(사용자 파일 특성 스키마 구성) 페이지의 스크린샷

다음 섹션에서는 특성 데이터 형식을 할당할 때 고려 사항을 나열합니다.

지원되는 데이터 형식

GCSV 커넥터는 다음 섹션 데이터 형식의 사용을 지원합니다.

부울: true 또는 false일 수 있는 값입니다.
이진: 일반적으로 이미지 또는 다른 파일과 같은 데이터를 저장하는 데 사용되는 바이트 시퀀스로 저장되는 값입니다.
정수: 소수 자릿수가 없는 정수 값입니다.
문자열: 일반적으로 텍스트 데이터를 저장하는 데 사용되는 문자 시퀀스인 값입니다.
참조: 다른 사용자 개체에 대한 참조인 값입니다. CSV 파일에서 참조 값을 지정하려면 해당 필드를 참조된 사용자 개체의 앵커 값으로 채웁니다.

중요

사용자 또는 그룹 참조 특성은 사용자 개체를 참조하는 데만 사용할 수 있습니다. 개체 형식 필드를 지정하는 한 사용자 또는 그룹 참조를 모두 포함할 수 있는 Group 개체의 Member 특성에는 적용되지 않습니다.

지원되는 Multiple-Value 데이터 형식

커넥터는 다음 데이터 형식에 대해서만 다중값 특성을 사용하도록 지원합니다.

String

참고

User 개체와 Group 개체의 스키마에 동일한 이름의 (비 앵커) 특성이 있는 경우 서로 다른 데이터 형식이 할당되지 않을 수 있습니다. 둘 다 동일한 데이터 형식을 공유해야 합니다.

스키마 4(그룹 파일 특성 스키마 구성)

이 페이지는 그룹 CSV 파일의 스키마에서 식별되는 각 필드의 데이터 형식을 지정하고 설명하고 둘 이상의 값을 가질 수 있는지 여부를 설명하기 위한 것입니다.

다음 이미지는 스키마 4(그룹 파일 특성 스키마 구성) 페이지의 예입니다.

그룹 파일 특성 스키마 구성 페이지의 스크린샷

스키마 3(사용자 파일 특성 구성)에서 제공하는 지침은 이 섹션에도 적용됩니다. .

초기 전체 가져오기 작업을 실행한 후 커넥터 공간은 다음 이미지와 유사하게 표시됩니다.

커넥터 공간 스크린샷

전역 매개 변수(PowerShell 스크립트 구성)

이 페이지에서는 가져오기 및/또는 내보내기 작업 전후에 실행되는 PowerShell 스크립트를 구성할 수 있습니다. 이러한 기능은 ID 사용자 및 그룹 레코드에 대해 다양한 사전 및 사후 처리 작업을 수행할 수 있는 기회를 제공합니다.

다음 이미지는 전역 매개 변수 페이지의 예입니다.

전역 매개 변수 페이지의 스크린샷

다음 섹션에서는 이 페이지의 개별 구성 설정을 나열합니다.

스크립트 시간 제한(분): 스크립트가 자동으로 중단되기 전에 실행될 시간(분)입니다. 이 설정의 기본값은 100이며 0 보다 큰 값이 필요합니다.
사전 가져오기 스크립트 파일: 가져오기 전에 실행해야 하는 PowerShell 스크립트에 대한 정규화된 경로입니다. 이 설정은 선택 사항이며 값이 필요하지 않습니다.
가져오기 후 스크립트 파일: 가져오기 후에 실행되어야 하는 PowerShell 스크립트에 대한 정규화된 경로입니다. 이 설정은 선택 사항이며 값이 필요하지 않습니다.
사전 내보내기 스크립트 파일: 내보내기 전에 실행해야 하는 PowerShell 스크립트에 대한 정규화된 경로입니다. 이 설정은 선택 사항이며 값이 필요하지 않습니다.
내보내기 후 스크립트 파일: 내보내기 후에 실행해야 하는 PowerShell 스크립트에 대한 정규화된 경로입니다. 이 설정은 선택 사항이며 값이 필요하지 않습니다.

PowerShell 스크립트 실행 및 입력 매개 변수

GCSV 커넥터는 자체 세션에서 구성된 각 PowerShell 스크립트를 실행하며 단계 간에 매개 변수 전달이 지원되지 않습니다.

커넥터는 하나의 입력 매개 변수를 OperationType이라는 각 스크립트에 전달합니다. 이 매개 변수의 값은 수행되는 프로필 실행 작업에 따라 다르며 다음 세 가지 값 중 하나일 수 있습니다.

중요

가져오기 또는 내보내기 작업 전에 CSV 파일의 동적 생성은 지원되지 않습니다. 실행 프로필이 실행되기 전에 모든 CSV 파일이 있어야 합니다.

PowerShell 입력 매개 변수: OperationType

입력 매개 변수의 사용은 지원되지 않지만 GCSV 커넥터는 하나의 입력 매개 변수를 모든 PowerShell 스크립트 OperationType의 실행에 전달합니다.

전체 – 이 값은 전체 가져오기 또는 전체 내보내기 작업 중에 제공됩니다.
Delta – 이 값은 내보내기 작업 중에 제공됩니다.

이 매개 변수 값은 PowerShell 스크립트의 논리 내에서 적절한 사전/사후 처리 작업 또는 수행할 작업을 결정하는 데 사용할 수 있습니다.

프로비전 계층 구조

CSV 파일은 계층 구조에 정보를 저장하지 않으므로 GCSV 커넥터는 계층적 프로비저닝 구성을 지원하지 않습니다.

다음 이미지는 프로비전 계층 페이지의 예입니다 .

계층 구조 프로비저닝 페이지의 스크린샷

파티션 및 계층 구조

GCSV 커넥터는 다음 LDAP 형식에 따라 커넥터 공간의 모든 사용자 및 그룹 레코드에 대해 고유한 DN(고유 이름)을 빌드합니다.

CN=[ANCHOR_VALUE],Object=User|Group,O=CSV

다음 이미지는 파티션 및 계층 페이지의 예입니다.

파티션 및 계층 구조 페이지의 스크린샷

개체 유형

GCSV 커넥터를 사용하려면 최소한 사용자 개체 형식을 선택해야 합니다. Group 개체 형식은 선택 사항입니다.

다음 이미지는 개체 형식 페이지의 예입니다.

개체 유형 페이지의 스크린샷

특성

이 페이지에는 선택한 모든 개체 형식 스키마에 대한 모든 특성의 정규화된 목록이 표시됩니다.

다음 이미지는 특성 페이지의 예입니다.

특성 페이지의 스크린샷

참고

Member 특성은 그룹을 선택한 경우에만 존재하며 그룹 구성원 CSV 파일에서 유지 관리되는 개체에 대한 참조를 포함합니다.

앵커

GCSV 커넥터는 해당 CSV 파일의 앵커 ID 필드와 다른 복잡한 앵커 또는 앵커 특성 구성의 사용을 지원하지 않습니다.

이 페이지에 표시된 앵커 지정을 변경하려면 스키마 2(앵커 구성)로 돌아갑니다.

다음 이미지는 앵커 페이지의 예 입니다 .

앵커 페이지 스크린샷

CSV 레코드 프로비전

GCSV 커넥터가 해당 CSV 파일에 새 User 또는 Group 개체를 추가하려면 새 Connector Space Object를 프로비전해야 합니다.

MIM 2016 선언적 프로비저닝을 사용하든, 사용자 고유의 MIM 동기화 규칙 확장을 작성하든 새 커넥터 공간 개체에는 다음 형식으로 구성된 DN이 있어야 합니다.

CN=[ANCHOR_VALUE],Object=User|Group,O=CSV

다음 표에서는 각 구성 요소 값에 대한 세부 정보를 제공합니다.

구성 요소	참고
CN=[ANCHOR VALUE]	CN(일반 이름)은 의 고유한 값이어야 하며 CSV 파일의 지정된 앵커 필드에 기록됩니다.
Object=User/Group	이 구성 요소는 이 커넥터의 개체 형식을 나타냅니다. "사용자" 또는 "그룹"만 지원합니다.
O=CSV	모든 GCSV 커넥터 공간 개체에 공통적인 루트 구성 요소입니다.

다음 이미지는 새 User 개체를 GCSV 커넥터에 프로비전할 때 DN을 올바르게 생성하는 방법을 보여 주는 동기화 규칙 입니다.

동기화 규칙 페이지 4의 스크린샷

다음 코드는 메타버스 규칙 확장을 사용하는 동등한 프로비저닝 논리를 보여 줍니다.

void IMVSynchronization.Provision(MVEntry mventry)
{
	if (mventry["employeeID"].IsPresent)
	{
		ConnectedMA GCSVConnector = = mventry.ConnectedMAs["Generic CSV Conenctor"];

		if (GCSVConnector.Connectors.Count == 0)
		{
			CSEntry csentry = GCSVConnector.Connectors.StartNewConnector("user");

			//Sets DN to "CN=[ANCHOR_VALUE],OBJECT=[User|Group],O=CSV"
			csentry.DN = GCSVConnector.EscapeDNComponent("CN=" + mventry["employeeID"].Value).Concat("OBJECT=User,O=CSV");

			csentry["AccountName"].StringValue = mventry["accountName"].StringValue;
			csentry["CountryCode"].IntegerValue = 1;
			csentry["DisplayName"].Value = mventry["displayName"].Value;
			csentry["ProxyAddresses"].Value = mventry["proxyAddressCollection"].Value;
			csentry["IsActive"].BooleanValue = true;
			csentry["Manager"].Value = mventry["manager"].Value;
			csentry["ProfilePic"].Value = mventry["pic"].Value;

			csentry.CommitNewConnector();
		}
	}
}

이전 이미지에서 함수를 EcapeDNComponent() 사용하여 앵커 값이 LDAP 구문을 준수하도록 올바르게 이스케이프되었는지 확인합니다.

중요

DN을 생성할 때 앵커 값을 잘못 이스케이프하면 오류가 발생합니다 invalid‑dn .

CSV 필드 서식 예제

다음 섹션에서는 CSV 파일에서 다른 데이터 형식의 서식을 지정하는 방법의 예를 나열합니다. 모든 예제 다음 섹션에서는 커넥터의 기본 필드 구분 기호 설정을 사용하는 것으로 가정합니다.

값 별도: 쉼표(,)
다중값 구분 기호: Semi-Colon(;)
텍스트 한정자: 큰따옴표(")

예: 텍스트 한정

문자열 값에 구분 기호로 해석되는 문자(예: 쉼표)가 포함된 경우 CSV 파서가 문자열을 단일 필드로 올바르게 해석할 수 있도록 값을 정규화해야 합니다.

다음 섹션 CSV 예제에서는 DisplayName 필드에 정규화된 텍스트로 서식이 지정된 값이 있는 방법을 보여 줍니다.

EmployeeID,DisplayName
E001,"Smith, John"
E002,"Doe, Jane"
E003,"Perez, Juan"

예: 다중값 문자열 구분

한 문자열 필드 내에 여러 문자열 값을 제공하려면 값을 다중값 구분 기호로 구분합니다. 다음 섹션 CSV 예제에서는 ProxyAddress 필드가 여러 값으로 표시되는 방법을 보여 줍니다.

EmployeeID,DisplayName,ProxyAddresses
E001,"Smith, John",SMTP:john.smith@contoso.com;smtp:js001@contoso.com
E002,"Doe, Jane",SMTP:jane.doe@contoso.com;smtp:jd002@contoso.com

참고

다중값 String은 문자열 정규화된 값의 사용도 지원합니다. 텍스트 정규화된 값은 다중값 구분 기호로 구분할 수 있습니다.

예: 참조 필드

CSV 파일에서 참조 값을 지정하려면 해당 필드를 참조된 사용자 개체의 앵커 값으로 채웁니다. 다음 섹션 CSV 예제에서 관리자 필드에는 참조하는 사용자 레코드의 앵커 값이 포함됩니다.

EmployeeID,DisplayName,Manager
E001,"Smith, John",
E002,"Doe, Jane",E001
E003,"Doe, Jane", 
E004,"Perez, Juan",

예: 이진 필드

CSV 파일에서 이진 값을 표현하려면 CSV 파일과 동일한 인코딩 형식을 사용하는 base64 문자열로 변환해야 합니다. 다음 섹션 PowerShell 함수는 문자열 값을 유니코드의 base64로 인코딩된 문자열로 인코딩하는 방법을 보여 줍니다.

function ConvertTo-Base64([string]$text) 
{
    $bytes = [System.Text.Encoding]::Unicode.GetBytes($text)
    $encodedText = [System.Convert]::ToBase64String($bytes)
    return $encodedText
}

다음은 text라는 입력 매개 변수를 수락하고 유니코드에서 base64로 인코딩된 문자열을 반환하는 C#의 동등한 함수입니다.

public static string ConvertToBase64(string text)
{
    byte[] bytes = System.Text.Encoding.UTF8.GetBytes(text);
    string encodedText = System.Convert.ToBase64String(bytes);
    return encodedText;
}

예: 부울 필드

부울 필드가 포함된 CSV 파일은 True 또는 False 텍스트를 사용하여 해당 값을 나타내야 합니다. 다음 섹션은 입니다.

EmployeeID,DisplayName,IsActive
E001,"Smith, John",true
E002,"Doe, Jane",true
E003,"Perez, Juan",false

알려진 제한 사항

다음 목록에는 GCSV 커넥터의 알려진 제한 사항이 포함되어 있습니다.

참조 특성
- 그룹 멤버 특성 외에 다중값 참조 특성은 지원되지 않습니다.
- 참조 값은 사용자 개체를 참조해야 합니다. 그룹 개체에 대한 참조는 지원되지 않습니다.
앵커
- 사용자 및 그룹 개체 간의 중복 앵커 값은 지원되지 않습니다.
- 앵커 특성의 이름은 사용자 및 그룹 스키마에서 고유해야 합니다.
PowerShell
- PowerShell 스크립트에 입력 변수를 전달하는 것은 지원되지 않습니다.

다음을 통해 공유