Microsoft Identity Manager 2016에 대한 함수 참조

MIM(Microsoft Identity Manager) 2016에서 함수를 사용하면 함수 작업 또는 선언적 프로비전의 대상으로 전달하기 전에 특성 값을 수정할 수 있습니다. 이 문서의 목적은 사용 가능한 함수에 대한 개요와 함수를 사용하는 방법에 대한 설명을 제공하기 위한 것입니다.

동기화 규칙을 구성할 때 특성 흐름 매핑 구성은 기본 작업입니다. 특성 흐름 매핑의 가장 간단한 형태는 직접 매핑입니다. 이름으로 표시된 대로 직접 매핑은 원본 특성의 값을 가져와 구성된 대상 특성에 적용합니다. 기존 특성 값을 수정해야 하거나 시스템에서 대상에 적용하기 전에 새 특성 값을 계산해야 하는 경우가 있습니다.

함수는 대상에 대한 특성 값을 생성할 때 동기화 엔진이 적용해야 하는 수정 유형을 정의하는 데 사용되는 기본 제공 메서드입니다.

MIM 함수는 다음 범주로 분산됩니다.

• 데이터 조작: 문자열에 대해 다양한 조작 작업을 수행합니다.

• 데이터 검색: 특성 값에서 데이터를 추출합니다.

• 데이터 생성: 값을 생성합니다.

• 논리: 조건에 따라 작업을 수행합니다.

다음 섹션에서는 각 범주의 함수에 대한 자세한 내용을 제공합니다.

데이터 조작 함수

데이터 조작 함수는 문자열에 대한 다양한 조작 작업을 수행하는 데 사용됩니다.

Concatenate	세부 정보
설명	연결 함수는 둘 이상의 문자열을 연결합니다.
함수 시그니처	string1 + string2...
입력	두 개 이상의 문자열입니다.
운영	모든 입력 문자열 매개 변수는 서로 연결됩니다.
출력	하나의 문자열입니다.

대문자	세부 정보
설명	UpperCase 함수는 문자열의 모든 문자를 대문자로 변환합니다.
함수 시그니처	String UpperCase(string)
입력	하나의 문자열입니다.
운영	입력 매개 변수의 모든 소문자는 대문자로 변환됩니다. 예를 들어 UpperCase("test")"TEST".
출력	하나의 문자열입니다.

소문자	세부 정보
설명	LowerCase 함수는 문자열의 모든 문자를 소문자로 변환합니다.
함수 시그니처	String LowerCase(string)
입력	하나의 문자열입니다.
운영	입력 매개 변수의 모든 대문자 문자는 소문자로 변환됩니다. 예를 들어 LowerCase("TeSt")"test".
출력	하나의 문자열입니다.

ProperCase	세부 정보
설명	ProperCase 함수는 문자열에서 공백으로 구분된 각 단어의 첫 번째 문자를 대문자로 변환합니다. 다른 모든 문자는 소문자로 변환됩니다.
함수 시그니처	String ProperCase(string)
입력	하나의 문자열입니다.
운영	입력 매개 변수에서 공백으로 구분된 모든 단어의 첫 번째 문자가 대문자로 변환됩니다. 모든 대문자 문자는 소문자로 변환됩니다. 입력 매개 변수의 단어가 알파벳이 아닌 문자로 시작하는 경우 단어의 첫 번째 문자는 대문자로 변환되지 않습니다. 다음은 그 예입니다. ProperCase("TEsT") "Test". ProperCase("britta simon") "Britta Simon". ProperCase(" TEsT") " Test". ProperCase("\$TEsT") "\$Test".
출력	하나의 문자열입니다.

LTrim	세부 정보
설명	LTrim 함수는 문자열에서 선행 공백을 제거합니다.
함수 시그니처	String LTrim(string)
입력	하나의 문자열입니다.
운영	입력 매개 변수에 포함된 선행 공백 문자가 제거됩니다. 예를 들어 LTrim(" Test ")"Test ".
출력	하나의 문자열입니다.

RTrim	세부 정보
설명	RTrim 함수는 문자열에서 후행 공백을 제거합니다.
함수 시그니처	String RTrim(string)
입력	하나의 문자열입니다.
운영	입력 매개 변수에 포함된 후행 공백 문자가 제거됩니다. 예를 들어 RTrim(" Test ")" Test".
출력	하나의 문자열입니다.

다듬다	세부 정보
설명	Trim 함수는 문자열에서 선행 공백과 후행 공백을 제거합니다.
함수 시그니처	String Trim(string)
입력	하나의 문자열입니다.
운영	문자열에 포함된 선행 및 후행 공백 문자가 제거됩니다. 예를 들어 Trim(" Test ")"Test".
출력	하나의 문자열입니다.

RightPad	세부 정보
설명	RightPad 함수는 제공된 안쪽 여백 문자를 사용하여 문자열을 지정된 길이로 오른쪽으로 패딩합니다.
함수 시그니처	String RightPad(string, length, padCharacter)
입력	문자열: 패딩할 문자열입니다. 길이: 문자열의 원하는 길이를 나타내는 정수입니다. padCharacter: 패드 문자로 사용할 단일 문자로 구성된 문자열입니다.
운영	문자열 길이가 길이보다 작으면 문자열 길이가 길이와 같을 때까지 padCharacter문자열 끝에 반복적으로 추가됩니다. 다음은 그 예입니다. RightPad("User", 10, "0") "User000000". RightPad(RandomNum(1,10), 5, "0") "9000"발생할 수 있습니다.
출력	문자열 길이가 길이크거나 같은 경우 문자열 동일한 문자열이 반환됩니다. 문자열 길이가 길이미만이면 원하는 길이의 새 문자열이 반환됩니다. 새 문자열에는 padCharacter패딩된 문자열이 포함됩니다. 문자열 null이면 함수는 빈 문자열을 반환합니다. 참고: padCharacter 공백 문자일 수 있지만 null 값일 수는 없습니다. 문자열 길이가 길이보다 크거나 같으면 문자열 변경되지 않은 상태로 반환됩니다.

LeftPad	세부 정보
설명	LeftPad 함수는 제공된 안쪽 여백 문자를 사용하여 문자열을 지정된 길이로 왼쪽에 패딩합니다.
함수 시그니처	String LeftPad(string, length, padCharacter)
입력	문자열: 패딩할 문자열입니다. 길이: 문자열의 원하는 길이를 나타내는 정수입니다. padCharacter: 패드 문자로 사용할 단일 문자로 구성된 문자열입니다.
운영	문자열 길이가 길이보다 작으면 문자열 길이가 길이와 같을 때까지 padCharacter문자열 시작 부분에 반복적으로 추가됩니다. 다음은 그 예입니다. RightPad("User", 10, "0") "000000User". RightPad(RandomNum(1,10), 5, "0") "0009"발생할 수 있습니다.
출력	문자열 길이가 길이크거나 같은 경우 문자열 동일한 문자열이 반환됩니다. 문자열 길이가 길이미만이면 원하는 길이의 새 문자열이 반환됩니다. 새 문자열에는 padCharacter패딩된 문자열이 포함됩니다. 문자열 null이면 함수는 빈 문자열을 반환합니다. 참고: padCharacter 공백 문자일 수 있지만 null 값일 수는 없습니다. 문자열 길이가 길이보다 크거나 같으면 문자열 변경되지 않은 상태로 반환됩니다.

BitOr	세부 정보
설명	BitOr 함수는 플래그의 지정된 비트를 1로 설정합니다.
함수 시그니처	Int BitOr(mask, flag)
입력	마스크: 플래그설정할 비트를 지정하는 16진수 값입니다. 플래그: 특정 비트를 수정하는 16진수 값입니다.
운영	이 함수는 두 매개 변수를 이진 표현으로 변환하고 비교합니다. 마스크 및 플래그 해당 비트 중 하나 또는 둘 다 1인 경우 비트를 1로 설정합니다. 해당 비트가 모두 0이면 비트를 0으로 설정합니다. 두 매개 변수의 해당 비트가 0인 경우를 제외하고 모든 경우에 1을 반환합니다. 결과 비트 패턴은 두 피연산자의 "set"(1 또는 true) 비트입니다. 여러 비트에 마스크값 1이 있는 경우 여러 플래그 비트를 설정할 수 있습니다.
출력	새 버전의 플래그는 마스크에 지정된 비트가 1로 설정된.

BitAnd	세부 정보
설명	BitAnd 함수는 플래그의 지정된 비트를 0으로 설정합니다.
함수 시그니처	Int BitOr(mask, flag)
입력	마스크: 플래그수정할 비트를 지정하는 16진수 값입니다. 플래그: 특정 비트를 수정하는 16진수 값입니다.
운영	이 함수는 두 매개 변수를 이진 표현으로 변환하고 비교합니다. 마스크 및 플래그 해당 비트 중 하나 또는 둘 다 0인 경우 비트를 0으로 설정합니다. 해당 비트가 모두 1이면 비트를 1로 설정합니다. 두 매개 변수의 해당 비트가 1인 경우를 제외하고 모든 경우에 0을 반환합니다. 여러 비트에 마스크값이 0인 경우 여러 플래그 비트를 0으로 설정할 수 있습니다.
출력	마스크에 지정된 비트가 0으로 설정된 새 버전의 플래그.

DateTimeFormat	세부 정보
설명	DateTimeFormat 함수는 문자열 형식의 DateTime 형식을 지정된 형식으로 지정하는 데 사용됩니다.
함수 시그니처	String DateTimeFormat(dateTime, format)
입력	dateTime: 서식을 지정할 DateTime을 나타내는 문자열입니다. 형식: 변환할 형식을 나타내는 문자열입니다. 참고: 사용자 정의 형식을 만드는 데 허용되는 문자는 사용자 정의 날짜/시간 형식참조하세요.
운영	형식 지정된 형식 문자열은 dateTime 문자열의 DateTime에 적용됩니다. 형식 지정된 문자열은 유효한 DateTime 형식이어야 합니다. 그렇지 않으면 형식이 유효한 DateTime 형식이 아님을 나타내는 오류가 반환됩니다. 예를 들어 DateTime("12/25/2007", "yyyy-MM-dd")"2007-12-25".
출력	dateTime 형식 적용한 결과 문자열입니다.

ConvertSidToString	세부 정보
설명	ConvertSidToString은 보안 식별자를 포함하는 바이트 배열을 문자열로 변환합니다.
함수 시그니처	String ConvertSidToString(ObjectSID)
입력	ObjectSID: SID(보안 식별자)를 포함하는 바이트 배열입니다.
운영	지정된 이진 SID가 문자열로 변환됩니다.
출력	SID의 문자열 표현입니다.

ConvertStringToGuid	세부 정보
설명	ConvertStringToGuid 함수는 GUID의 문자열 표현을 GUID의 이진 표현으로 변환합니다.
함수 시그니처	Byte[] ConvertStringToGuid(stringGuid)
입력	stringGuid: 패턴 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx서식이 지정된 문자열입니다. 여기서 GUID 값은 8, 4, 4, 4, 12자리 그룹에서 일련의 16진수 숫자로 표현되고 하이픈으로 구분됩니다. 반환 값의 예는 382c74c3-721d-4f34-80e557657b6cbc27.
운영	stringGuid 이진 표현으로 변환됩니다. 문자열이 유효한 GUID의 표현이 아닌 경우 함수는 "ConvertStringToGuid 함수의 매개 변수는 유효한 Guid를 나타내는 문자열이어야 합니다."라는 오류와 함께 인수를 거부합니다.
출력	GUID의 이진 표현입니다.

ReplaceString	세부 정보
설명	ReplaceString 함수는 문자열의 모든 항목을 다른 문자열로 바꿉니다.
함수 시그니처	String ReplaceString(string, OldValue, NewValue)
입력	문자열: 값을 바꿀 문자열입니다. OldValue: 검색하고 바꿀 문자열입니다. NewValue: 바꿀 문자열입니다.
운영	문자열OldValue 모두 NewValue바뀝니다. 함수는 \n특수 문자를 처리할 수 있어야 합니다. 새 줄을\r. 캐리지 리턴을 \t. 탭을. 예: ReplaceString("One\n\rMicrosoft\n\r\Way","\n\r"," ")"One Microsoft Way"반환합니다.
출력	문자열에서 OldValue 모든 항목이 NewValue로 대체된 문자열입니다.

데이터 검색 함수

데이터 검색 함수는 문자열에서 원하는 문자를 검색하는 작업을 수행하는 데 사용됩니다.

단어	세부 정보
설명	Word 함수는 사용할 구분 기호를 설명하는 매개 변수에 따라 문자열 내에 포함된 단어와 반환할 단어 수를 반환합니다.
함수 시그니처	String Word(string, number, delimiters)
입력	문자열: 단어를 반환할 문자열입니다. 숫자: 반환해야 하는 단어 번호를 식별하는 숫자입니다. 구분 기호: 단어를 식별하는 데 사용해야 하는 구분 기호를 나타내는 문자열입니다.
운영	문자열의 각 문자열은 구분 기호 문자 중 하나로 구분되는 단어로 식별됩니다. 문자열 null이면 함수는 빈 문자열을 반환합니다. 번호 지정된 위치에서 찾은 단어가 반환됩니다. 숫자< 1이면 함수는 빈 문자열을 반환합니다. 다음은 그 예입니다. Word("Test;of%function;", 3, ";$&%")은(는) "function"을(를) 반환합니다. Word("Test;;Function" , 2 , ";") ""(빈 문자열)를 반환합니다. Word("Test;of%function;", 0, ";$&%") ""(빈 문자열)를 반환합니다.
출력	사용자가 요청한 위치에 있는 단어가 들어 있는 문자열입니다. 문자열 단어의 개수 미만을 포함하거나 문자열구분 기호로 식별되는 단어를 포함하지 않는 경우 빈 문자열을 반환됩니다.

왼쪽	세부 정보
설명	Left 함수는 문자열의 왼쪽(시작)에서 지정된 수의 문자를 반환합니다.
함수 시그니처	String Left(string, numChars)
입력	문자열: 문자를 반환할 문자열입니다. numChars: 문자열의 시작 부분에서 반환할 문자 수를 식별하는 숫자입니다.
운영	numChars 문자는 문자열첫 번째 위치에서 반환됩니다. 예: Left("Britta Simon", 3)"Bri"반환합니다.
출력	문자열첫 번째 numChars 문자를 포함하는 문자열입니다. numChars = 0을 경우 함수는 빈 문자열을 반환합니다. numChars <경우 함수는 입력 문자열을 반환합니다. 문자열 null이면 함수는 빈 문자열을 반환합니다.

오른쪽	세부 정보
설명	Right 함수는 문자열의 오른쪽(끝)부터 지정된 수의 문자를 반환합니다.
함수 시그니처	String Right(string, numChars)
입력	문자열: 문자를 반환할 문자열입니다. numChars: 문자열의 끝에서 반환할 문자 수를 식별하는 숫자입니다.
운영	문자열끝에서 numChars 문자를 반환합니다. 예: Right("Britta Simon", 3)"mon"반환합니다.
출력	문자열마지막 numChars 문자를 포함하는 문자열입니다. numChars = 0을 경우 함수는 빈 문자열을 반환합니다. numChars <경우 함수는 입력 문자열을 반환합니다. 문자열 null이면 함수는 빈 문자열을 반환합니다. 문자열numChars지정된 수보다 적은 문자가 포함된 경우 문자열 반환됩니다.

중간	세부 정보
설명	Mid 함수는 문자열의 지정된 위치부터 지정된 수의 문자를 반환합니다.
함수 시그니처	String Mid(string, pos, numChars)
입력	문자열: 문자를 반환할 문자열입니다. pos: 문자를 반환하기 위한 문자열의 시작 위치를 식별하는 숫자입니다. numChars : 문자열의 위치에서 반환할 문자 수를 식별하는 숫자입니다.
운영	문자열위치 pos 시작하는 numChars 문자를 반환합니다. 예: Mid("Britta Simon", 3, 5)"itta "반환합니다.
출력	문자열위치의 numChars 문자를 포함하는 문자열입니다. numChars = 0을 경우 함수는 빈 문자열을 반환합니다. numChars <경우 함수는 빈 문자열을 반환합니다. > 경우 함수는 입력 문자열을 반환합니다. pos<= 0이면 함수는 입력 문자열을 반환합니다. 문자열 null이면 함수는 빈 문자열을 반환합니다. 위치 pos 문자열에 남아 있는 numChar 문자가 없으면 가능한 한 많은 문자가 반환됩니다.

데이터 생성 함수

데이터 생성 함수는 특정 데이터 형식에 대한 값을 생성하는 데 사용됩니다.

CRLF	세부 정보
설명	CRLF 함수는 캐리지 리턴/줄 바꿈을 생성합니다. 이 함수를 사용하여 새 줄을 추가합니다.
함수 시그니처	String CRLF
입력	없음.
운영	CRLF가 반환됩니다. 다음은 그 예입니다. AddressLine1 + CRLF() + AddressLine2 결과 AddressLine1 AddressLine2;
출력	CRLF는 출력입니다.

RandomNum	세부 정보
설명	RandomNum 함수는 지정된 간격 내에서 난수를 반환합니다.
함수 시그니처	Int RandomNum(start, end)
입력	시작: 생성할 임의 값의 하한을 식별하는 숫자입니다. 끝: 생성할 임의 값의 상한을 식별하는 숫자입니다.
운영	시작 보다 크거나 같은 난수가 생성되고 끝 보다 작거나 같습니다. 예를 들어 Random(0,999)100반환할 수 있습니다.
출력	시작 및 끝 지정한 범위 내의 난수입니다.

EscapeDNComponent	세부 정보
설명	MIISUtils의 EscapeDNComponent 메서드는 이 작업을 수행하는 데 사용됩니다. 이 메서드는 사용 중인 MA(관리 에이전트) 형식에 따라 입력 문자열을 처리합니다.
함수 시그니처	String EscapeDNComponent(string)
입력	문자열: 고유 이름을 처리하는 데 사용되는 문자열입니다. 문자열에는 이스케이프된 문자가 포함되어서는 안 됩니다.
운영	다른 MA에는 서로 다른 고유 이름 형식이 필요합니다. 이 메서드는 다음 MA 형식에 따라 입력 문자열 처리합니다. LDAP 고유 이름: 이 MA 유형의 예로는 Active Directory Domain Services, Sun Directory Server(이전의 iPlanet Directory Server) 및 Microsoft Exchange Server가 있습니다. 지정된 파트의 값 부분에 있는 잘못된 XML 문자는 16진수로 인코딩됩니다. 지정된 부분의 이름 부분에 잘못된 문자(잘못된 XML 문자 포함)가 있으면 오류가 발생합니다. 이스케이프된 문자에는 쉼표(,), 등호(=), 더하기(+), 보다 작음(<), 보다 큼(>), 숫자(#), 세미콜론(;), 백슬래시() 및 큰따옴표(")가 포함됩니다. 문자열 마지막 문자가 공백()이면 해당 공백이 이스케이프됩니다. 부품 이름 주위의 불필요한 선행 또는 후행 공백이 제거됩니다. XML MA의 경우 여러 부분이 있는 경우 파트는 사전순으로 정렬됩니다. 여러 부분을 지정하는 경우 복합 고유 이름 문자열은 더하기(+) 기호로 구분된 개별 문자열의 연결입니다. 입력 문자열 올바른 형식의 LDAP 스타일 고유 이름 문자열이 아닌 경우 오류가 생성됩니다. 계층적 비 LDAP: 이러한 유형의 MA의 예는 Microsoft Lotus Notes입니다. 이 MA 형식은 다중 파트 구성 요소를 지원하지 않습니다. 여러 문자열이 EscapeDNComponent전달되면 ArgumentException throw됩니다. 입력 문자열 있는 문자가 잘못된 XML 문자인 경우 ArgumentException throw됩니다. 입력 문자열 모든 쉼표(,) 및 백슬라이시(/)가 이스케이프됩니다. 문자열 마지막 문자가 공백()이면 해당 공백이 이스케이프됩니다. extrinsic: 이 MA 형식의 예로는 LDAP 고유 이름이 없는 데이터베이스 또는 XML이 포함됩니다. 해당 부분이 이진이거나 잘못된 XML 문자를 포함하는 경우 해당 부분은 문자열 앞에 숫자(#) 문자가 접두사로 추가된 원시 데이터의 16진수로 인코딩된 버전으로 저장됩니다. 예를 들어 부품이 AxC 경우(여기서 x는 0x10같은 잘못된 XML 문자를 나타낸 경우) 해당 부분은 #410010004300인코딩됩니다. 그렇지 않으면 백슬래시(), 쉼표(,), 더하기(+) 및 숫자(#)와 같은 문자의 모든 인스턴스가 이스케이프됩니다. 지정된 부분 문자열의 마지막 문자가 공백()이면 해당 공간이 이스케이프됩니다. 여러 부분을 지정하는 경우 복합 고유 이름 문자열은 더하기 기호로 구분된 모든 개별 문자열의 연결입니다.
출력	유효한 도메인 이름을 포함하는 문자열입니다.

메모

고유 이름의 유효성 검사는 LDAP 사양에 정의된 구문보다 덜 엄격합니다. EscapeDNComponent(String[]) 파트 이름에 하나 이상의 문자 'a'-'z', 'A'-'Z', '0'-'9', '-', '.'의 조합을 포함할 수 있습니다.

이 메서드를 사용하여 이진 부분을 지정할 수 없습니다. 그러나 고유 이름이 앵커 특성에서 생성되고 앵커 특성 중 하나가 이진 형식인 경우 CommitNewConnector 이진 부분이 있을 수 있습니다.

없음	세부 정보
설명	Null 함수는 MA에 기여할 특성이 없고 해당 특성 우선 순위가 다음 MA에서 계속되어야 함을 지정하는 데 사용됩니다.
함수 시그니처	String Null
입력	없음.
운영	Null이 반환됩니다. 예: IIF(Eq(domain), "unknown", Null())Null반환합니다.
출력	Null은 출력입니다.

논리 함수

논리 함수는 시스템에서 평가한 조건에 따라 작업을 수행하는 데 사용됩니다.

IIF	세부 정보
설명	IIF 함수는 지정된 조건에 따라 가능한 값 집합 중 하나를 반환합니다.
함수 시그니처	Object IIF(condition, valueIfTrue, valueIfFalse)
입력	조건: true 또는 false로 평가할 수 있는 모든 값 또는 식입니다. 다음 함수는 조건의 IIF 함수에서 식으로 사용할 수 Eq: 이 함수는 두 인수를 같음으로 비교합니다. NotEquals: 이 함수는 같지 않은 경우 true를 반환하고 같지 않은 경우 false를 반환하는 두 인수를 비교합니다. 예: NotEquals(EmployeeType, "Contractor"). LessThan: 이 함수는 두 숫자를 비교하여 첫 번째 숫자가 두 번째 숫자보다 작으면 true를 반환하고 그렇지 않으면 false를 반환합니다. 예: LessThan(Salary, 100000). GreaterThan: 이 함수는 두 숫자를 비교하여 첫 번째 숫자가 두 번째 숫자보다 크면 true를 반환하고, 그렇지 않으면 false를 반환합니다. 예: GreaterThan(Salary, 100000). LessThanOrEquals: 이 함수는 두 숫자를 비교하여 첫 번째 숫자가 두 번째 숫자보다 작거나 같으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. 예: LessThanOrEquals(Salary, 100000). GreaterThanOrEquals: 이 함수는 두 숫자를 비교하여 첫 번째 숫자가 두 번째 숫자보다 크거나 같으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. 예: GreaterThanOrEquals(Salary, 100000). IsPresent: 이 함수는 ILM 스키마의 특성을 입력으로 사용하고 특성이 null이 아니면 true를 반환하고, 특성이 null이면 false를 반환합니다. valueIfTrue: 조건이 true로 평가되면 반환되는 값입니다. valueIfFalse: 조건 false로 평가되면 반환되는 값입니다.
운영	조건 true로 평가되면 함수는 valueIfTrue반환합니다. 그렇지 않으면 함수는 valueIfFalse반환합니다. 예를 들어 IIF(Eq(EmployeeType,"Intern"),"t-" + Alias, Alias) 사용자가 인턴인 경우 별칭의 시작 부분에 "t-"가 추가된 사용자의 별칭을 반환합니다. 그렇지 않으면 함수는 사용자의 별칭 as-is반환합니다.
출력	조건이 true이면 출력이 valueIfTrue, 조건이 false이면 valueIfFalse .