다음을 통해 공유


Azure Active Directory 동기화 함수 참조

업데이트: 2015년 7월 22일

중요하다

이 항목은 곧 보관될 예정입니다.
AADSync 및 DirSync를 대체하는 "Azure Active Directory Connect"라는 새 제품이 있습니다.
Azure AD Connect는 이전에 Dirsync 및 AAD Sync로 릴리스된 구성 요소와 기능을 통합합니다.
나중에 Dirsync 및 AAD Sync에 대한 지원이 종료됩니다.
이러한 도구는 더 이상 기능 향상으로 개별적으로 업데이트되지 않으며 향후 모든 개선 사항이 Azure AD Connect 업데이트에 포함됩니다.

Azure Active Directory Connect에 대한 최신 정보는 온-프레미스 ID를 Azure Active Directory 통합하는 참조하세요.

Azure Active Directory Sync에서 함수는 동기화 중에 특성 값을 조작하는 데 사용됩니다.
함수의 구문은 다음 형식으로 표현됩니다.
<출력 형식> FunctionName(<입력 형식><위치 이름>, ..)

함수가 오버로드되고 여러 구문을 허용하는 경우 유효한 모든 구문이 나열됩니다.
함수는 강력한 형식이며 전달된 형식이 문서화된 형식과 일치하는지 확인합니다. 형식이 일치하지 않으면 오류가 throw됩니다.

형식은 다음 구문으로 표현됩니다.

  • bin – 이진

  • 부울 – 부울

  • dt – UTC 날짜/시간

  • 열거형 – 알려진 상수의 열거형

  • exp – 식입니다. 이 식은 부울로 계산되어야 합니다.

  • mvbin – 다중값 이진

  • mvstr – 다중 값 참조

  • num – 숫자

  • ref – 단일 값 참조

  • str – 단일 값 문자열

  • var – 거의 모든 다른 형식의 변형

  • void – 값을 반환하지 않습니다.

함수 목록

이 섹션에서는 다음 함수에 대한 설명을 제공합니다.

  • BitAnd

  • BitOr

  • CBool

  • CDate

  • CGuid

  • 포함

  • ConvertFromBase64

  • ConvertFromUTF8Hex

  • ConvertToBase64

  • ConvertToUTF8Hex

  • 세다

  • CNum

  • CRef

  • CStr

  • DateAdd

  • DateFromNum

  • DNComponent

  • DNComponentRev

  • 오류

  • EscapeDNComponent

  • FormatDateTime

  • GUID

  • IIF

  • InStr

  • InStrRev

  • IsBitSet

  • IsDate

  • IsEmpty

  • IsGuid

  • IsNull

  • IsNullOrEmpty

  • IsNumeric

  • IsString

  • IsPresent

  • 항목

  • ItemOrNull

  • 잇다

  • LCase

  • 왼쪽

  • LTrim

  • 중간

  • 지금

  • NumFromDate

  • PadLeft

  • PadRight

  • PCase

  • RandomNum

  • RemoveDuplicates

  • 갈다

  • ReplaceChars

  • 오른쪽

  • RTrim

  • 쪼개다

  • StringFromGuid

  • StringFromSid

  • 스위치

  • 다듬다

  • UCase

  • 단어

BitAnd

설명

BitAnd 함수는 값에 지정된 비트를 설정합니다.

구문

num BitAnd(num value1, num value2)

value1, value2: AND'ed를 함께 사용해야 하는 숫자 값

설명

이 함수는 두 매개 변수를 이진 표현으로 변환하고 마스크 및 플래그의 해당 비트 중 하나 또는 둘 다 0인 경우 비트를 0으로 설정하고, 해당 비트가 모두 1이면 1로 설정합니다.

즉, 두 매개 변수의 해당 비트가 1인 경우를 제외하고 모든 경우에 0을 반환합니다.

예제

BitAnd(&HF, &HF7)

16진수 "F" 및 "F7"이 이 값으로 평가되므로 7로 평가됩니다.

BitOr

설명

BitOr 함수는 값에 지정된 비트를 설정합니다.

구문

num BitOr(num value1, num value2)

value1, value2: OR'ed를 함께 사용해야 하는 숫자 값

설명

이 함수는 두 매개 변수를 이진 표현으로 변환하고 마스크 및 플래그의 해당 비트 중 하나 또는 둘 다 1인 경우 비트를 1로 설정하고, 해당 비트가 모두 0이면 0으로 설정합니다.

즉, 두 매개 변수의 해당 비트가 0인 경우를 제외하고 모든 경우에 1을 반환합니다.

예제

CBool

설명

CBool 함수는 계산된 식에 따라 부울을 반환합니다.

구문

bool CBool(exp Expression)

설명

식이 0이 아닌 값으로 계산되면 CBool은 True를 반환합니다. 그렇지 않으면 False를 반환합니다.

예제

CBool([attrib1] = [attrib2])

두 특성의 값이 같으면 True를 반환합니다.

CDate

설명

CDate 함수는 문자열에서 UTC DateTime을 반환합니다. DateTime은 동기화의 네이티브 특성 형식이 아니지만 일부 함수에서 사용됩니다.

구문

dt CDate(str value)

값: 날짜, 시간 및 선택적으로 표준 시간대가 있는 문자열

설명

반환된 문자열은 항상 UTC입니다.

본보기

CDate([employeeStartTime])

직원의 시작 시간을 기준으로 DateTime을 반환합니다.

CDate("2013-01-10 4:00 PM -8")

"2013-01-11 오전 12:00"을 나타내는 DateTime을 반환합니다.

CGuid

설명

CGuid 함수는 Guid의 문자열 표현을 Guid의 이진 표현으로 변환합니다.

구문

bin CGuid(str GUID)GUID: 이 패턴에서 형식이 지정된 문자열: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 또는 {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxx}

설명

예제

포함

설명

Contains 함수는 다중값 특성 내에서 문자열을 찾습니다.

구문

num Contains(mvstring attribute, str search) //case sensitive

num Contains(mvstring 특성, str search, enum Casetype)

num Contains(mvref 특성, str search) // 대/소문자 구분

attribute: 검색할 다중값 특성입니다.

검색: 특성에서 찾을 문자열입니다.

Casetype: CaseInsensitive 또는 CaseSensitive

문자열이 발견된 다중값 특성의 인덱스 반환 문자열을 찾을 수 없는 경우 0이 반환됩니다.

설명

다중값 문자열 특성의 경우 검색은 값에서 부분 문자열을 찾습니다.

참조 특성의 경우 검색된 문자열이 일치하는 것으로 간주될 값과 정확히 일치해야 합니다.

예제

IIF(Contains([proxyAddresses],"SMTP:")>0,[proxyAddresses],Error("기본 SMTP 주소를 찾을 수 없습니다."))

proxyAddresses 특성에 기본 전자 메일 주소(대문자 "SMTP:"로 표시됨)가 있는 경우 proxyAddress 특성을 반환하고 그렇지 않으면 오류를 반환합니다.

ConvertFromBase64

설명

ConvertFromBase64 함수는 지정된 base64로 인코딩된 값을 일반 문자열로 변환합니다.

구문

str ConvertFromBase64(str source) //는 인코딩을 위해 유니코드를 가정합니다.

str ConvertFromBase64(str source, enum Encoding)

원본: Base64로 인코딩된 문자열

인코딩: 유니코드, ASCII, UTF8

설명

예제

ConvertFromBase64("SABlAGwAbABvACAAdwBvAHIAbABkACEA")

ConvertFromBase64("SGVsbG8gd29ybGQh", UTF8)

둘 다 "Hello world!"를 반환합니다.

ConvertFromUTF8Hex

설명

ConvertFromUTF8Hex 함수는 지정된 UTF8 Hex로 인코딩된 값을 문자열로 변환합니다.

구문

str ConvertFromUTF8Hex(str source)

원본: UTF8 2 바이트 인코딩된 sting

설명

이 함수는 결과가 DN 특성에 친숙하다는 측면에서 ConvertFromBase64([],UTF8)와 다릅니다. 이 형식은 Azure Active Directory에서 DN으로 사용됩니다.

예제

ConvertFromUTF8Hex("48656C6C6F20776F726C6421")

"Hello world!"를 반환합니다.

ConvertToBase64

설명

ConvertToBase64 함수는 문자열을 유니코드 base64 문자열로 변환합니다.

정수 배열의 값을 base-64 숫자로 인코딩된 해당 문자열 표현으로 변환합니다.

구문

str ConvertToBase64(str source)

발언

예제

ConvertToBase64("Hello world!")

"SABlAGwAbABvACAAdwBvAHIAbABkACEA"를 반환합니다.

ConvertToUTF8Hex

설명

ConvertToUTF8Hex 함수는 문자열을 UTF8 16진수로 인코딩된 값으로 변환합니다.

구문

str ConvertToUTF8Hex(str source)

설명

이 함수의 출력 형식은 Azure Active Directory에서 DN 특성 형식으로 사용됩니다.

예제

ConvertToUTF8Hex("Hello world!")

48656C6C6F20776F726C6421을 반환합니다.

세다

설명

Count 함수는 다중값 특성의 요소 수를 반환합니다.

구문

num Count(mvstr attribute)

설명

예제

CNum

설명

CNum 함수는 문자열을 사용하고 숫자 데이터 형식을 반환합니다.

구문

num CNum(str value)

설명

예제

CRef

설명

문자열을 참조 특성으로 변환합니다.

구문

ref CRef(str value)

설명

예제

CRef("CN=LC Services,CN=Microsoft,CN=lcspool01, CN=Pools,CN=RTC Service," & %Forest. LDAP%)

CStr

설명

CStr 함수는 문자열 데이터 형식으로 변환됩니다.

구문

str CStr(num value)

str CStr(ref value)

str CStr(bool value)

값: 숫자 값, 참조 특성 또는 부울일 수 있습니다.

설명

예제

CStr([dn])

"cn=Joe,dc=contoso,dc=com"을 반환할 수 있습니다.

DateAdd

설명

지정된 시간 간격이 추가된 날짜를 포함하는 날짜를 반환합니다.

구문

dt DateAdd(str interval, num value, dt date)

간격: 추가할 시간 간격인 문자열 식입니다. 문자열에는 다음 값 중 하나가 있어야 합니다.

yyyy 년

q 분기

mMonth

yDay of year

dDay

wWeekday

wwWeek

hHour

nMinute

sSecond

값: 추가할 단위 수입니다. 양수(나중에 날짜를 가져오는 경우) 또는 음수(과거의 날짜를 가져오기 위해)일 수 있습니다.

날짜: 간격이 추가되는 날짜를 나타내는 DateTime입니다.

설명

예제

DateAdd("m", 3, CDate("2001-01-01")),

3개월을 추가하고 "2001-04-01"을 나타내는 DateTime을 반환합니다.

DateFromNum

설명

DateFromNum 함수는 AD의 날짜 형식 값을 DateTime 형식으로 변환합니다.

구문

dt DateFromNum(num value)

설명

예제

DateFromNum([lastLogonTimestamp])

DateFromNum(129699324000000000)

2012-01-01 23:00:00을 나타내는 DateTime을 반환합니다.

DNComponent

설명

DNComponent 함수는 왼쪽에서 진행하는 지정된 DN 구성 요소의 값을 반환합니다.

구문

str DNComponent(ref dn, num ComponentNumber)

dn: 해석할 참조 특성

ComponentNumber: 반환할 DN의 구성 요소

설명

예제

DNComponent([dn],1)

dn이 "cn=Joe,ou=... 그러면 Joe가 반환될 것입니다.

DNComponentRev

설명

DNComponentRev 함수는 오른쪽(끝)에서 이동한 지정된 DN 구성 요소의 값을 반환합니다.

구문

str DNComponentRev(ref dn, num ComponentNumber)

str DNComponentRev(ref dn, num ComponentNumber, enum Options)dn: 해석할 참조 특성

ComponentNumber: 반환할 DN의 구성 요소

옵션: DC – "dc="를 사용하여 모든 구성 요소 무시

설명

예제

dn이 "cn=Joe,ou=Atlanta,ou=GA,ou=US, dc=contoso,dc=com"인 경우 DNComponentRev([dn],3)

DNComponentRev([dn],1,"DC")

둘 다 미국을 반환할 것입니다.

오류

설명

오류 함수는 사용자 지정 오류를 반환하는 데 사용됩니다.

구문

void Error(str ErrorMessage)

설명

예제

IIF(IsPresent([accountName]),[accountName],Error("AccountName 필수"))

attribute accountName이 없으면 개체에 오류를 throw합니다.

EscapeDNComponent

설명

EscapeDNComponent 함수는 DN의 한 구성 요소를 사용하여 LDAP로 나타낼 수 있도록 이스케이프합니다.

구문

str EscapeDNComponent(str value)

설명

예제

EscapeDNComponent("cn=" & [displayName]) & "," & %ForestLDAP%

displayName 특성에 LDAP에서 이스케이프해야 하는 문자가 있더라도 개체를 LDAP 디렉터리에 만들 수 있는지 확인합니다.

FormatDateTime

설명

FormatDateTime 함수는 DateTime을 지정된 형식의 문자열에 서식을 지정하는 데 사용됩니다.

구문

str FormatDateTime(dt value, str format)value: DateTime 형식의 값

format: 변환할 형식을 나타내는 문자열입니다.

설명

형식에 사용할 수 있는 값은 다음에서 찾을 수 있습니다.

https://msdn2.microsoft.com/library/73ctwf33(VS.90).aspx

예제

FormatDateTime(CDate("12/25/2007"),"yyyy-mm-dd")

결과는 "2007-12-25"입니다.

FormatDateTime(DateFromNum([pwdLastSet]),"yyyyMMddHHmmss.0Z")

"20140905081453.0Z"가 발생할 수 있습니다.

GUID

설명

함수 GUID는 새 임의 GUID를 생성합니다.

구문

str GUID()

설명

예제

IIF

설명

IIF 함수는 지정된 조건에 따라 가능한 값 집합 중 하나를 반환합니다.

구문

var IIF(exp condition, var valueIfTrue, var valueIfFalse)condition: true 또는 false로 평가할 수 있는 모든 값 또는 식입니다.

valueIfTrue: 조건이 true로 평가되면 반환되는 값입니다.

valueIfFalse: 조건이 false로 평가되면 반환되는 값입니다.

설명

예제

IIF([employeeType]="Intern","t-"&[alias],[alias])

사용자가 인턴인 경우 시작 부분에 "t-"가 추가된 사용자의 별칭을 반환하고, 그렇지 않으면 사용자의 별칭을 있는 그대로 반환합니다.

InStr

설명

InStr 함수는 문자열에서 첫 번째 부분 문자열을 찾습니다.

구문

num InStr(str stringcheck, str stringmatch)

num InStr(str stringcheck, str stringmatch, num start)

num InStr(str stringcheck, str stringmatch, num start, enum compare)

Stringcheck: 검색할 문자열

Stringmatch: 찾을 문자열

시작: 부분 문자열을 찾기 위한 시작 위치

비교: vbTextCompare 또는 vbBinaryCompare

발언

부분 문자열이 발견된 위치 또는 0을 찾을 수 없는 경우 반환합니다.

예제

InStr("빠른 갈색 여우","빠른")

Evalues to 5

InStr("repEated","e",3,vbBinaryCompare)

7로 평가

InStrRev

설명

InStrRev 함수는 문자열에서 부분 문자열의 마지막 발생을 찾습니다.

구문

num InstrRev(str stringcheck, str stringmatch)

num InstrRev(str stringcheck, str stringmatch, num start)

num InstrRev(str stringcheck, str stringmatch, num start, enum compare)

Stringcheck: 검색할 문자열

Stringmatch: 찾을 문자열

시작: 부분 문자열을 찾기 위한 시작 위치

비교: vbTextCompare 또는 vbBinaryCompare

설명

부분 문자열이 발견된 위치 또는 0을 찾을 수 없는 경우 반환합니다.

예제

InStrRev("abbcdbbbef","bb")

7로 평가

IsBitSet

설명

비트가 설정되어 있는지 여부를 테스트하는 IsBitSet 함수

구문

bool IsBitSet(num value, num flag)

value: evaluated.flag인 숫자 값: 평가할 비트가 있는 숫자 값입니다.

설명

예제

IsBitSet(&HF,4)

비트 "4"가 16진수 값 "F"로 설정되어 있기 때문에 True로 평가됩니다.

IsDate

설명

식이 DateTime 형식으로 계산될 수 있으면 IsDate 함수가 True로 평가됩니다.

구문

bool IsDate(var Expression)

설명

CDate()가 성공할지 확인하는 데 사용됩니다.

예제

IsEmpty

설명

특성이 CS 또는 MV에 있지만 빈 문자열로 계산되는 경우 IsEmpty 함수는 True로 평가됩니다.

구문

bool IsEmpty(var Expression)

설명

예제

IsGuid

설명

문자열을 GUID로 변환할 수 있는 경우 IsGuid 함수는 true로 평가됩니다.

구문

bool IsGuid(str GUID)

설명

GUID는 xxxxxxxx-xxxx-xx 또는 {xx-xxxx-xxxx-xx} 패턴 중 하나에 따라 문자열로 정의됩니다.

CGuid()가 성공할지 확인하는 데 사용됩니다.

예제

IIF(IsGuid([strAttribute]),CGuid([strAttribute]),NULL)

StrAttribute에 GUID 형식이 있는 경우 이진 표현을 반환하고, 그렇지 않으면 Null을 반환합니다.

IsNull

설명

식이 Null로 평가되면 IsNull 함수는 true를 반환합니다.

구문

bool IsNull(var Expression)

설명

특성의 경우 특성이 없으므로 Null이 표현됩니다.

예제

IsNull([displayName])

CS 또는 MV에 특성이 없으면 True로 평가됩니다.

IsNullOrEmpty

설명

식이 null이거나 빈 문자열인 경우 IsNullOrEmpty 함수는 true를 반환합니다.

구문

bool IsNullOrEmpty(var Expression)

설명

특성의 경우 특성이 없거나 존재하지만 빈 문자열인 경우 True로 평가됩니다.

이 함수의 역방향 이름은 IsPresent입니다.

예제

IsNull([displayName])

특성이 없거나 CS 또는 MV에 빈 문자열인 경우 True로 평가됩니다.

IsNumeric

설명

IsNumeric 함수는 식을 숫자 형식으로 평가할 수 있는지 여부를 나타내는 부울 값을 반환합니다.

구문

bool IsNumeric(var Expression)

설명

CNum()이 식을 구문 분석하는 데 성공할지 여부를 확인하는 데 사용됩니다.

예제

IsString

묘사

식이 문자열 형식으로 계산될 수 있으면 IsString 함수가 True로 평가됩니다.

구문

bool IsString(var expression)

설명

CStr()이 식을 구문 분석하는 데 성공할지 여부를 확인하는 데 사용됩니다.

예제

IsPresent

설명

식이 Null이 아니고 비어 있지 않은 문자열로 계산되면 IsPresent 함수는 true를 반환합니다.

구문

bool IsPresent(var expression)

설명

이 함수의 역 이름은 IsNullOrEmpty입니다.

예제

Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])

항목

설명

Item 함수는 다중값 문자열/특성에서 하나의 항목을 반환합니다.

구문

var Item(mvstr attribute, num index)

특성: 다중값 특성

index: 다중값 문자열의 항목에 대한 인덱스입니다.

설명

Item 함수는 후자의 함수가 다중값 특성의 항목에 인덱스를 반환하기 때문에 Contains 함수와 함께 유용합니다.

인덱스가 범위를 벗어나면 오류를 throw합니다.

예제

Mid(Item([proxyAddress],Contains([proxyAddress], "SMTP:")),6)

는 기본 전자 메일 주소를 반환합니다.

ItemOrNull

설명

ItemOrNull 함수는 다중값 문자열/특성에서 하나의 항목을 반환합니다.

구문

var ItemOrNull(mvstr attribute, num index)

특성: 다중값 특성

index: 다중값 문자열의 항목에 대한 인덱스입니다.

설명

ItemOrNull 함수는 후자의 함수가 다중값 특성의 항목에 인덱스를 반환하기 때문에 Contains 함수와 함께 유용합니다.

인덱스가 범위를 벗어나면 Null 값을 반환합니다.

예제

잇다

설명

Join 함수는 다중값 문자열을 사용하고 각 항목 사이에 지정된 구분 기호가 삽입된 단일 값 문자열을 반환합니다.

구문

str Join(mvstr attribute)

str Join(mvstr attribute, str Delimiter)attribute: 조인할 문자열을 포함하는 다중값 특성입니다.

구분 기호: 반환된 문자열의 부분 문자열을 구분하는 데 사용되는 모든 문자열입니다. 생략하면 공백 문자(" ")가 사용됩니다. 구분 기호가 길이가 0인 문자열("") 또는 Nothing인 경우 목록의 모든 항목은 구분 기호 없이 연결됩니다.

설명

Join 함수와 Split 함수 사이에는 패리티가 있습니다. Join 함수는 문자열 배열을 가져와 구분 기호 문자열을 사용하여 조인하여 단일 문자열을 반환합니다. Split 함수는 문자열을 가져와 구분 기호에서 구분하여 문자열 배열을 반환합니다. 그러나 주요 차이점은 조인이 모든 구분 기호 문자열과 문자열을 연결할 수 있다는 것입니다. Split는 단일 문자 구분 기호를 사용하여 문자열만 구분할 수 있습니다.

예제

Join([proxyAddresses],")

반환 가능: "SMTP:john.doe@contoso.com,smtp:jd@contoso.com"

LCase

설명

LCase 함수는 문자열의 모든 문자를 소문자로 변환합니다.

구문

str LCase(str value)

설명

예제

LCase("TeSt")

결과는 "test"입니다.

왼쪽

설명

Left 함수는 문자열 왼쪽에서 지정된 수의 문자를 반환합니다.

구문

str Left(str string, num NumChars)string: 문자를 반환할 문자열입니다.

NumChars: 문자열의 시작 부분(왼쪽)에서 반환할 문자 수를 식별하는 숫자입니다.

설명

문자열의 첫 번째 numChars 문자를 포함하는 문자열입니다.

•numChars = 0이면 빈 문자열을 반환합니다.

•numChars < 0이면 입력 문자열을 반환합니다.

•문자열이 null이면 빈 문자열을 반환합니다.

문자열에 numChars에 지정된 숫자보다 적은 문자가 포함된 경우 문자열과 동일한 문자열(즉, 매개 변수 1의 모든 문자 포함)이 반환됩니다.

예제

Left("John Doe", 3)

"Joh"를 반환합니다.

설명

Num 함수는 문자열의 문자 수를 반환합니다.

구문

num Len(str value)

설명

예제

Len("John Doe")

8을 반환합니다.

LTrim

설명

LTrim 함수는 문자열에서 선행 공백을 제거합니다.

구문

str LTrim(str value)

설명

본보기

LTrim(" Test ")

"테스트" 결과

중간

설명

Mid 함수는 문자열의 지정된 위치에서 지정된 수의 문자를 반환합니다.

구문

str Mid(str string, num start, num NumChars)

string: 문자를 반환할 문자열입니다.

start: 문자열에서 문자를 반환할 시작 위치를 식별하는 숫자입니다.

NumChars: 문자열의 위치에서 반환할 문자 수를 식별하는 숫자입니다.

설명

문자열의 위치 시작부터 시작하는 numChars 문자를 반환합니다.

문자열의 위치 시작에서 numChars 문자를 포함하는 문자열입니다.

•numChars = 0이면 빈 문자열을 반환합니다.

•numChars < 0이면 입력 문자열을 반환합니다.

•문자열 길이를 > 시작하면 입력 문자열을 반환합니다.

•<= 0을 시작하면 입력 문자열을 반환합니다.

•문자열이 null이면 빈 문자열을 반환합니다.

위치 시작부터 문자열에 남아 있는 numChar 문자가 없으면 반환할 수 있는 만큼의 문자가 반환됩니다.

예제

Mid("John Doe", 3, 5)

"hn Do"를 반환합니다.

Mid("John Doe", 6, 999)

"Doe"를 반환합니다.

지금

설명

Now 함수는 컴퓨터의 시스템 날짜 및 시간에 따라 현재 날짜와 시간을 지정하는 DateTime을 반환합니다.

구문

dt Now()

설명

예제

NumFromDate

설명

NumFromDate 함수는 AD의 날짜 형식으로 날짜를 반환합니다.

구문

num NumFromDate(dt value)

설명

예제

NumFromDate(CDate("2012-01-01 23:00:00"))

129699324000000000 반환합니다.

PadLeft

설명

PadLeft 함수는 제공된 패딩 문자를 사용하여 문자열을 지정된 길이로 왼쪽으로 채움합니다.

구문

str PadLeft(str string, num length, str padCharacter)

string: 패딩할 문자열입니다.

length: 원하는 문자열 길이를 나타내는 정수입니다.

padCharacter: 패드 문자로 사용할 단일 문자로 구성된 문자열입니다.

설명

문자열 길이가 길이보다 작으면 길이가 같을 때까지 문자열의 시작 부분(왼쪽)에 padCharacter가 반복적으로 추가됩니다.

padCharacter는 공백 문자일 수 있지만 null 값일 수는 없습니다.

문자열 길이가 길이보다 크거나 같으면 문자열은 변경되지 않고 반환됩니다.

문자열의 길이가 길이보다 크거나 같으면 문자열과 동일한 문자열이 반환됩니다.

문자열 길이가 길이보다 작으면 padCharacter로 패딩된 문자열을 포함하는 원하는 길이의 새 문자열이 반환됩니다.

문자열이 null이면 함수는 빈 문자열을 반환합니다.

예제

PadLeft("User", 10, "0")

"000000User"가 발생합니다.

PadRight

설명

PadRight 함수는 제공된 안쪽 여백 문자를 사용하여 문자열을 지정된 길이로 오른쪽으로 패딩합니다.

구문

str PadRight(str string, num length, str padCharacter)

string: 패딩할 문자열입니다.

length: 원하는 문자열 길이를 나타내는 정수입니다.

padCharacter: 패드 문자로 사용할 단일 문자로 구성된 문자열입니다.

설명

문자열 길이가 길이보다 작으면 길이가 같을 때까지 문자열의 끝(오른쪽)에 padCharacter가 반복적으로 추가됩니다.

padCharacter는 공백 문자일 수 있지만 null 값일 수는 없습니다.

문자열 길이가 길이보다 크거나 같으면 문자열은 변경되지 않고 반환됩니다.

문자열의 길이가 길이보다 크거나 같으면 문자열과 동일한 문자열이 반환됩니다.

문자열 길이가 길이보다 작으면 padCharacter로 패딩된 문자열을 포함하는 원하는 길이의 새 문자열이 반환됩니다.

문자열이 null이면 함수는 빈 문자열을 반환합니다.

예제

PadRight("User", 10, "0")

"User000000"이 발생합니다.

PCase

설명

PCase 함수는 문자열에서 공백으로 구분된 각 단어의 첫 번째 문자를 대문자로 변환하고 다른 모든 문자는 소문자로 변환됩니다.

구문

문자열 PCase(string)

설명

예제

PCase("TEsT")

결과는 "Test"입니다.

RandomNum

설명

RandomNum 함수는 지정된 간격 사이의 난수를 반환합니다.

구문

num RandomNum(num start, num end)

start: 생성할 임의 값의 하한을 식별하는 숫자

끝: 생성할 임의 값의 상한을 식별하는 숫자

설명

예제

Random(100,999)

는 734를 반환할 수 있습니다.

RemoveDuplicates

설명

RemoveDuplicates 함수는 다중값 문자열을 사용하고 각 값이 고유한지 확인합니다.

구문

mvstr RemoveDuplicates(mvstr attribute)

설명

예제

RemoveDuplicates([proxyAddresses])

모든 중복 값이 제거된 삭제된 proxyAddress 특성을 반환합니다.

갈다

설명

Replace 함수는 문자열의 모든 항목을 다른 문자열로 바꿉니다.

구문

str Replace(str string, str OldValue, str NewValue)

string: 값을 바꿀 문자열입니다.

OldValue: 검색하고 바꿀 문자열입니다.

NewValue: 바꿀 문자열입니다.

설명

함수는 다음과 같은 특수 모니커를 인식합니다.

\n – 새 줄

\r – 캐리지 리턴

\t – Tab

예제

Replace([address],"\r\n",", ")

CRLF를 쉼표와 공간으로 바꾸고 "One Microsoft Way, Redmond, WA, USA"로 이어질 수 있습니다.

ReplaceChars

설명

ReplaceChars 함수는 ReplacePattern 문자열에 있는 모든 문자를 대체합니다.

구문

str ReplaceChars(str string, str ReplacePattern)

string: 문자를 바꿀 문자열입니다.

ReplacePattern: 바꿀 문자가 있는 사전이 포함된 문자열입니다. 형식은 {source1}:{target1},{source2}:{target2},{sourceN},{targetN}입니다. 여기서 원본은 바꿀 문자열을 찾고 대상으로 지정할 문자입니다.

설명

함수는 정의된 원본의 각 항목을 가져와서 대상으로 바꿉니다.

원본은 정확히 하나의(유니코드) 문자여야 합니다.

원본은 비어 있거나 한 문자보다 길 수 없습니다(구문 분석 오류).

대상에는 여러 문자(예: ö:oe, β:ss)가 있을 수 있습니다.

대상은 문자를 제거해야 함을 나타내는 비어 있을 수 있습니다.

원본은 대/소문자를 구분하며 정확히 일치해야 합니다.

, (쉼표) 및 : (콜론)은 예약된 문자이며 이 함수를 사용하여 바꿀 수 없습니다.

ReplacePattern 문자열의 공백 및 기타 흰색 문자는 무시됩니다.

예제

%ReplaceString% = ':,Å:A,Ä:A,Ö:O,å:a,ä:a,ö,o

ReplaceChars("Räksmörgås",%ReplaceString%)

Raksmorgas를 반환합니다.

ReplaceChars("O'Neil",%ReplaceString%)

"ONeil"을 반환합니다. 단일 틱이 제거되도록 정의됩니다.

설명

Right 함수는 문자열의 오른쪽(끝)에서 지정된 수의 문자를 반환합니다.

구문

str Right(str string, num NumChars)

string: 문자를 반환할 문자열입니다.

NumChars: 문자열의 끝(오른쪽)에서 반환할 문자 수를 식별하는 숫자입니다.

발언

NumChars 문자는 문자열의 마지막 위치에서 반환됩니다.

문자열의 마지막 numChars 문자를 포함하는 문자열입니다.

•numChars = 0이면 빈 문자열을 반환합니다.

•numChars < 0이면 입력 문자열을 반환합니다.

•문자열이 null이면 빈 문자열을 반환합니다.

문자열에 NumChars에 지정된 숫자보다 적은 문자가 포함된 경우 문자열과 동일한 문자열이 반환됩니다.

예제

Right("John Doe", 3)

"Doe"를 반환합니다.

RTrim

설명

RTrim 함수는 문자열에서 후행 공백을 제거합니다.

구문

str RTrim(str value)

설명

예제

RTrim(" Test ")

결과는 "Test"입니다.

쪼개다

설명

Split 함수는 구분 기호로 구분된 문자열을 사용하여 다중값 문자열로 만듭니다.

구문

mvstr Split(str value, str delimiter)

mvstr Split(str value, str delimiter, num limit)

값: 구분할 구분 기호 문자가 있는 문자열입니다.

구분 기호: 구분 기호로 사용할 단일 문자

제한: 반환될 최대 값 수

설명

예제

Split("SMTP:john.doe@contoso.com,smtp:jd@contoso.com",",")

proxyAddress 특성에 유용한 2개 요소가 있는 다중값 문자열을 반환합니다.

StringFromGuid

묘사

StringFromGuid 함수는 이진 GUID를 사용하여 문자열로 변환합니다.

통사론

str StringFromGuid(bin GUID)

발언

본보기

StringFromSid

설명

StringFromSid 함수는 보안 식별자를 포함하는 바이트 배열 또는 다중값 바이트 배열을 문자열 또는 다중값 문자열로 변환합니다.

구문

str StringFromSid(bin ObjectSID)

mvstr StringFromSid(mvbin ObjectSID)

설명

예제

스위치

설명

Switch 함수는 평가된 조건에 따라 단일 값을 반환하는 데 사용됩니다.

구문

var Switch(exp expr1, var value1[, exp expr2, var value ... [, exp expr, var valueN]])

Expr: 평가할 Variant 식입니다.

값: 해당 식이 True이면 반환할 값입니다.

설명

Switch 함수 인수 목록은 식과 값 쌍으로 구성됩니다. 식은 왼쪽에서 오른쪽으로 계산되고 True로 계산할 첫 번째 식과 연결된 값이 반환됩니다. 파트가 제대로 페어링되지 않으면 런타임 오류가 발생합니다.

예를 들어 expr1이 True이면 Switch는 value1을 반환합니다. expr-1이 False이지만 expr-2가 True이면 Switch는 value-2 등을 반환합니다.

Switch는 다음과 같은 경우 Nothing을 반환합니다.

  • True 식은 없습니다.

  • 첫 번째 True 식에는 Null인 해당 값이 있습니다.

Switch는 식을 하나만 반환하더라도 모든 식을 평가합니다. 이러한 이유로, 바람직하지 않은 부작용에 대 한 감시 해야 합니다. 예를 들어 식의 계산으로 인해 0으로 나누기 오류가 발생하는 경우 오류가 발생합니다.

값은 사용자 지정 문자열을 반환하는 Error 함수일 수도 있습니다.

예제

Switch([city] = "London", "English", [city] = "Rome", "Italian", [city] = "Paris", "French", True, Error("Unknown city"))

일부 주요 도시에서 사용되는 언어를 반환하고, 그렇지 않으면 오류를 반환합니다.

다듬다

설명

Trim 함수는 문자열에서 선행 공백과 후행 공백을 제거합니다.

구문

str Trim(str value)

mvstr Trim(mvstr value)

설명

예제

Trim(" Test ")

결과는 "Test"입니다.

Trim([proxyAddresses])

proxyAddress 특성의 각 값에 대한 선행 및 후행 공백을 제거합니다.

UCase

묘사

UCase 함수는 문자열의 모든 문자를 대문자로 변환합니다.

구문

str UCase(str string)

설명

예제

UCase("TeSt")

는 "TEST"가 됩니다.

단어

설명

Word 함수는 사용할 구분 기호와 반환할 단어 번호를 설명하는 매개 변수를 기반으로 문자열 내에 포함된 단어를 반환합니다.

구문

str Word(str string, num WordNumber, str delimiters)

string: 다음에서 단어를 반환할 문자열입니다.

WordNumber: 반환해야 하는 단어 번호를 식별하는 숫자입니다.

구분 기호: 단어를 식별하는 데 사용해야 하는 구분 기호를 나타내는 문자열입니다.

설명

구분 기호의 문자 중 하나로 구분된 문자열의 각 문자열은 단어로 식별됩니다.

•숫자 < 1이면 빈 문자열을 반환합니다.

•문자열이 null이면 빈 문자열을 반환합니다.

문자열에 숫자보다 작은 단어가 포함되거나 문자열에 구분 기호로 식별되는 단어가 없는 경우 빈 문자열이 반환됩니다.

예제

Word("빠른 갈색 여우",3," ")

"brown"을 반환합니다.

Word("This,string!has&many seperators",3,",!&#")

"has"를 반환합니다.

참고 항목

개념

Azure Active Directory 동기화