Partilhar via

Referência de funções de sincronização do Ative Directory do Azure

  • Artigo

Atualizado: July 22, 2015

Importante

Este tópico será arquivado em breve.
Há um novo produto chamado "Azure Ative Directory Connect" que substitui o AADSync e o DirSync.
O Azure AD Connect incorpora os componentes e a funcionalidade lançados anteriormente como Dirsync e AAD Sync.
Em algum momento no futuro, o suporte para Dirsync e AAD Sync terminará.
Essas ferramentas não estão mais sendo atualizadas individualmente com aprimoramentos de recursos e todas as melhorias futuras serão incluídas nas atualizações do Azure AD Connect.

Para obter as informações mais recentes sobre o Azure Ative Directory Connect, consulte Integrando suas identidades locais com o Azure Ative Directory

Na Sincronização do Ative Directory do Azure, as funções são usadas para manipular um valor de atributo durante a sincronização.
A sintaxe das funções é expressa usando o seguinte formato:
<tipo de saída> FunctionName(<tipo de entrada><nome da posição>, ..)

Se uma função estiver sobrecarregada e aceitar várias sintaxes, todas as sintaxes válidas serão listadas.
As funções são fortemente tipadas e verificam se o tipo passado corresponde ao tipo documentado. Um erro será lançado se o tipo não corresponder.

Os tipos são expressos com a seguinte sintaxe:

  • bin – Binário

  • bool – Booleano

  • dt – Data/Hora UTC

  • enum – Enumeração de constantes conhecidas

  • exp – Expressão, que se espera avaliar a um booleano

  • mvbin – Binário Multi-Valor

  • mvstr – Referência Multivalorada

  • num – Numérico

  • ref – Referência de Valor Único

  • str – String de valor único

  • var – Uma variante de (quase) qualquer outro tipo

  • nulo – não retorna um valor

Lista de funções

Esta seção fornece descrições para as seguintes funções:

  • BitAnd

  • BitOr

  • CBool

  • CDate

  • CGuid

  • Contém

  • ConvertFromBase64

  • ConvertFromUTF8Hex

  • ConvertToBase64

  • ConvertToUTF8Hex

  • Contagem

  • CNum

  • CRef

  • CStr

  • DataAdicionar

  • DateFromNum

  • DNComponent

  • DNComponentRev

  • Erro

  • EscapeDNComponent

  • FormatDateTime

  • GUID

  • IIF

  • InStr

  • InStrRev

  • IsBitSet

  • IsDate

  • IsEmpty

  • IsGuid

  • IsNull

  • IsNullOrEmpty

  • IsNumeric

  • IsString

  • IsPresent

  • Número

  • ItemOrNull

  • Aderir

  • LCase

  • Esquerda

  • Len

  • LTrim

  • Média

  • Agora

  • NumFromDate

  • PadLeft

  • PadRight

  • PCase

  • RandomNum

  • RemoveDuplicates

  • Substituir

  • ReplaceChars

  • Certo

  • RTrim

  • Divisão

  • StringFromGuid

  • StringFromSid

  • Mudar

  • Guarnição

  • UCase

  • Palavra

BitAnd

Descrição

A função BitAnd define bits especificados em um valor.

Sintaxe

num BitAnd(num value1, num value2)

value1, value2: valores numéricos que devem ser AND'ed juntos

Observações

Esta função converte ambos os parâmetros para a representação binária e define um bit para 0 se um ou ambos os bits correspondentes na máscara e sinalizador forem 0, e para 1 se ambos os bits correspondentes forem 1.

Em outras palavras, ele retorna 0 em todos os casos, exceto quando os bits correspondentes de ambos os parâmetros são 1.

Exemplo

BitAnd(&HF, &HF7)

Avalia até 7, uma vez que os hexadecimais "F" E "F7" avaliam este valor.

BitOr

Descrição

A função BitOr define bits especificados em um valor.

Sintaxe

num BitOr(num value1, num value2)

value1, value2: valores numéricos que devem ser OR'ed juntos

Observações

Esta função converte ambos os parâmetros em representação binária e define um bit para 1 se um ou ambos os bits correspondentes na máscara e sinalizador forem 1, e para 0 se ambos os bits correspondentes forem 0.

Em outras palavras, ele retorna 1 em todos os casos, exceto quando os bits correspondentes de ambos os parâmetros são 0.

Exemplo

CBool

Descrição

A função CBool retorna um booleano com base na expressão avaliada

Sintaxe

bool CBool(exp Expressão)

Observações

Se a expressão for avaliada para um valor diferente de zero, CBool retornará True. Caso contrário, ele retorna False.

Exemplo

CBool([attrib1] = [attrib2])

Retorna True se ambos os atributos tiverem o mesmo valor.

CDate

Descrição

A função CDate retorna um UTC DateTime de uma cadeia de caracteres. DateTime não é um tipo de atributo nativo no Sync, mas é usado por algumas funções.

Sintaxe

dt CDate (valor str)

Valor: uma cadeia de caracteres com data, hora e, opcionalmente, fuso horário

Observações

A cadeia de caracteres retornada está sempre em UTC.

Exemplo

CDate([funcionárioStartTime])

Retorna um DateTime com base na hora de início do funcionário

CDate("2013-01-10 16:00 -8")

Devolve um DateTime que representa "2013-01-11 12:00"

CGuid

Descrição

A função CGuid converte a representação de cadeia de caracteres de um Guid em uma representação binária do Guid.

Sintaxe

bin CGuid(str GUID)GUID: A String formatada neste padrão: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ou {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

Observações

Exemplo

Contém

Descrição

A função Contains localiza uma cadeia de caracteres dentro de um atributo de vários valores

Sintaxe

num Contém (atributo mvstring, str search) // sensível a maiúsculas e minúsculas

num Contém (atributo mvstring, str search, enum Casetype)

num Contém (atributo mvref, str search) // sensível a maiúsculas e minúsculas

Atributo: O atributo de vários valores a ser pesquisado.

Pesquisa: string para encontrar no atributo.

Tipo de caso: CaseInsensitive ou CaseSensitive

Retorna o índice no atributo de vários valores onde a cadeia de caracteres foi encontrada. 0 é retornado se a cadeia de caracteres não for encontrada.

Observações

Para atributos de cadeia de caracteres de vários valores, a pesquisa encontrará substrings nos valores.

Para atributos de referência, a cadeia de caracteres pesquisada deve corresponder exatamente ao valor a ser considerado uma correspondência.

Exemplo

IIF(Contém([proxyAddresses],"SMTP:")>0,[proxyAddresses],Error("Nenhum endereço SMTP primário encontrado."))

Se o atributo proxyAddresses tiver um endereço de e-mail principal (indicado por "SMTP:" maiúsculo), retorne o atributo proxyAddress, caso contrário, retorne um Error.

ConvertFromBase64

Descrição

A função ConvertFromBase64 converte o valor codificado base64 especificado em uma cadeia de caracteres regular.

Sintaxe

str ConvertFromBase64(str source) // assume Unicode para codificação

str ConvertFromBase64(fonte str, codificação enum)

Fonte: Cadeia codificada Base64

Codificação: Unicode, ASCII, UTF8

Observações

Exemplo

ConvertFromBase64("SABlAGwAbABvACAAdwBvAHIAbABkACEA")

ConvertFromBase64("SGVsbG8gd29ybGQh", UTF8)

Ambos retornam "Olá mundo!"

ConvertFromUTF8Hex

Descrição

A função ConvertFromUTF8Hex converte o valor codificado UTF8 Hex especificado em uma cadeia de caracteres.

Sintaxe

str ConvertFromUTF8Hex (fonte str)

fonte: UTF8 picada codificada de 2 bytes

Observações

Esta função é diferente de ConvertFromBase64([],UTF8) porque o resultado é amigável para o atributo DN. Esse formato é usado pelo Azure Ative Directory como DN.

Exemplo

ConvertFromUTF8Hex("48656C6C6F20776F726C6421")

Retorna "Olá mundo!"

ConvertToBase64

Descrição

A função ConvertToBase64 converte uma cadeia de caracteres em uma cadeia de caracteres Unicode base64.

Converte o valor de uma matriz de inteiros em sua representação de cadeia de caracteres equivalente que é codificada com dígitos de base 64.

Sintaxe

str ConvertToBase64(fonte str)

Comentários

Exemplo

ConvertToBase64("Olá mundo!")

Devolve "SABlAGwAbABvACAAdwBvAHIAbABkACEA"

ConvertToUTF8Hex

Descrição

A função ConvertToUTF8Hex converte uma cadeia de caracteres em um valor codificado em UTF8 Hex.

Sintaxe

str ConvertToUTF8Hex (fonte str)

Observações

O formato de saída desta função é usado pelo Azure Ative Directory como o formato de atributo DN.

Exemplo

ConvertToUTF8Hex("Olá mundo!")

Devolve 48656C6C6F20776F726C6421

Contagem

Descrição

A função Count retorna o número de elementos em um atributo de vários valores

Sintaxe

num Count(atributo mvstr)

Observações

Exemplo

CNum

Descrição

A função CNum usa uma cadeia de caracteres e retorna um tipo de dados numéricos.

Sintaxe

num CNum(valor str)

Observações

Exemplo

CRef

Descrição

Converte uma cadeia de caracteres em um atributo de referência

Sintaxe

ref CRef (valor str)

Observações

Exemplo

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

CStr

Descrição

A função CStr converte em um tipo de dados de cadeia de caracteres.

Sintaxe

str CStr(num valor)

str CStr(valor ref)

str CStr (valor bool)

Valor: Pode ser um valor numérico, um atributo de referência ou um booleano.

Observações

Exemplo

CStr([dn])

Pode retornar "cn=Joe,dc=contoso,dc=com"

DataAdicionar

Descrição

Retorna uma Data contendo uma data à qual um intervalo de tempo especificado foi adicionado.

Sintaxe

dt DateAdd(intervalo str, valor num, data dt)

Intervalo: expressão de cadeia de caracteres que é o intervalo de tempo que você deseja adicionar. A cadeia de caracteres deve ter um dos seguintes valores:

Ano aaaa

q Trimestre

mMês

yDia do ano

dDia

wDia da semana

wwSemana

hHora

nMinuto

sSegundo

Valor: o número de unidades que você deseja adicionar. Pode ser positivo (para obter datas no futuro) ou negativo (para obter datas no passado).

Data: DateTime que representa a data à qual o intervalo é adicionado.

Observações

Exemplo

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

Adiciona 3 meses e retorna um DateTime representando "2001-04-01"

DateFromNum

Descrição

A função DateFromNum converte um valor no formato de data do AD em um tipo DateTime.

Sintaxe

dt DateFromNum(valor num)

Observações

Exemplo

DateFromNum([lastLogonTimestamp])

DataDeNúm(129699324000000000)

Devolve um DateTime que representa 2012-01-01 23:00:00

DNComponent

Descrição

A função DNComponent retorna o valor de um componente DN especificado indo da esquerda.

Sintaxe

str DNComponent(ref dn, num ComponentNumber)

DN: O atributo de referência a ser interpretado

ComponentNumber: O componente no DN a ser retornado

Observações

Exemplo

DNComponent([dn],1)

Se dn for "cn=Joe,ou=... isso devolveria Joe

DNComponentRev

Descrição

A função DNComponentRev retorna o valor de um componente DN especificado indo da direita (o fim).

Sintaxe

str DNComponentRev(ref dn, num ComponentNumber)

str DNComponentRev(ref dn, num ComponentNumber, enum Options)dn: o atributo de referência a ser interpretado

ComponentNumber: O componente no DN a ser retornado

Opções: DC – ignore todos os componentes com "dc="

Observações

Exemplo

Se dn for "cn=Joe,ou=Atlanta,ou=GA,ou=US, dc=contoso,dc=com" então DNComponentRev([dn],3)

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

ambos devolveriam os EUA.

Erro

Descrição

A função Error é usada para retornar um erro personalizado.

Sintaxe

void Error(str ErrorMessage)

Observações

Exemplo

IIF(IsPresent([accountName]),[accountName],Error("AccountName is required"))

Se o atributo accountName não estiver presente, lance um erro no objeto.

EscapeDNComponent

Descrição

A função EscapeDNComponent pega um componente de um DN e escapa dele para que possa ser representado no LDAP.

Sintaxe

str EscapeDNComponent(valor str)

Observações

Exemplo

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

Certifica-se de que o objeto pode ser criado em um diretório LDAP, mesmo que o atributo displayName tenha caracteres que devem ser escapados no LDAP.

FormatDateTime

Descrição

A função FormatDateTime é usada para formatar um DateTime para uma cadeia de caracteres com um formato especificado

Sintaxe

str FormatDateTime(dt value, str format)value: um valor no formato DateTime

Formato: uma cadeia de caracteres que representa o formato para o qual converter.

Observações

Os valores possíveis para o formato podem ser encontrados aqui:

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

Exemplo

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

Resultados em "2007-12-25".

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

Pode resultar em "20140905081453.0Z"

GUID

Descrição

A função GUID gera um novo GUID aleatório

Sintaxe

str GUID()

Observações

Exemplo

IIF

Descrição

A função IIF retorna um de um conjunto de valores possíveis com base em uma condição especificada.

Sintaxe

var IIF(exp condition, var valueIfTrue, var valueIfFalse)condition: qualquer valor ou expressão que possa ser avaliada como true ou false.

valueIfTrue: um valor que será retornado se a condição for avaliada como true.

valueIfFalse: um valor que será retornado se a condição for avaliada como false.

Observações

Exemplo

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

Retorna o alias de um usuário com "t-" adicionado ao início dele se o usuário for um estagiário, caso contrário, retorna o alias do usuário como está.

InStr

Descrição

A função InStr localiza a primeira ocorrência de uma substring em uma string

Sintaxe

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: string a ser pesquisada

Stringmatch: string a ser encontrada

Iniciar: posição inicial para encontrar a substring

Compare: vbTextCompare ou vbBinaryCompare

Comentários

Retorna a posição onde a substring foi encontrada ou 0 se não for encontrada.

Exemplo

InStr("A raposa castanha rápida","rápida")

Valores até 5

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

Avalia até 7

InStrRev

Descrição

A função InStrRev localiza a última ocorrência de uma substring em uma string

Sintaxe

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: string a ser pesquisada

Stringmatch: string a ser encontrada

Iniciar: posição inicial para encontrar a substring

Compare: vbTextCompare ou vbBinaryCompare

Observações

Retorna a posição onde a substring foi encontrada ou 0 se não for encontrada.

Exemplo

InStrRev("abbcdbbbef","bb")

Avalia até 7

IsBitSet

Descrição

A função IsBitSet testa se um bit está definido ou não

Sintaxe

bool IsBitSet(num valor, num flag)

value: um valor numérico que é avaliado.flag: um valor numérico que tem o bit a ser avaliado

Observações

Exemplo

IsBitSet(&HF,4)

Avalia como True uma vez que o bit "4" é definido no valor hexadecimal "F"

IsDate

Descrição

A função IsDate é avaliada como True se a expressão puder ser avaliada como um tipo DateTime.

Sintaxe

bool IsDate(expressão var)

Observações

Usado para determinar se CDate() será bem-sucedido.

Exemplo

IsEmpty

Descrição

A função IsEmpty avalia como True se o atributo está presente no CS ou MV, mas é avaliada como uma cadeia de caracteres vazia.

Sintaxe

bool IsEmpty(expressão var)

Observações

Exemplo

IsGuid

Descrição

A função IsGuid avaliada como true se a cadeia de caracteres pudesse ser convertida em um GUID.

Sintaxe

bool IsGuid (GUID str)

Observações

Um GUID é definido como uma cadeia de caracteres seguindo um destes padrões: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ou {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

Usado para determinar se CGuid() será bem-sucedido.

Exemplo

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

Se o StrAttribute tiver um formato GUID, retorne uma representação binária, caso contrário, retorne um Null.

IsNull

Descrição

A função IsNull retornará true se a expressão for avaliada como Null.

Sintaxe

bool IsNull(expressão var)

Observações

Para um atributo, um Null é expresso pela ausência do atributo.

Exemplo

IsNull([displayName])

Avaliaria como True se o atributo não estiver presente no CS ou MV.

IsNullOrEmpty

Descrição

A função IsNullOrEmpty retornará true se a expressão for nula ou uma cadeia de caracteres vazia.

Sintaxe

bool IsNullOrEmpty(expressão var)

Observações

Para um atributo, isso avaliaria como True se o atributo está ausente ou está presente, mas é uma cadeia de caracteres vazia.

O inverso desta função é chamado IsPresent.

Exemplo

IsNull([displayName])

Avaliaria como True se o atributo não estiver presente ou for uma cadeia de caracteres vazia no CS ou MV.

IsNumeric

Descrição

A função IsNumeric retorna um valor booleano que indica se uma expressão pode ser avaliada como um tipo de número.

Sintaxe

bool IsNumeric(var Expressão)

Observações

Usado para determinar se CNum() será bem-sucedido para analisar a expressão.

Exemplo

IsString

Descrição

A função IsString é avaliada como True se a expressão puder ser avaliada para um tipo de cadeia de caracteres.

Sintaxe

bool IsString(expressão var)

Observações

Usado para determinar se CStr() será bem-sucedido para analisar a expressão.

Exemplo

IsPresent

Descrição

A função IsPresent retornará true se a expressão for avaliada como uma cadeia de caracteres que não é Nula e não está vazia.

Sintaxe

bool IsPresent(expressão var)

Observações

O inverso dessa função é chamado IsNullOrEmpty.

Exemplo

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

Número

Descrição

A função Item retorna um item de uma cadeia de caracteres/atributo de vários valores.

Sintaxe

var Item(atributo mvstr, num index)

Atributo: Atributo de vários valores

índice: índice para um item na cadeia de caracteres de vários valores.

Observações

A função Item é útil juntamente com a função Contains uma vez que esta última função retornará o índice para um item no atributo de vários valores.

Lança um erro se o índice estiver fora dos limites.

Exemplo

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

devolveria o endereço de e-mail principal.

ItemOrNull

Descrição

A função ItemOrNull retorna um item de uma cadeia de caracteres/atributo de vários valores.

Sintaxe

var ItemOrNull(atributo mvstr, num index)

Atributo: Atributo de vários valores

índice: índice para um item na cadeia de caracteres de vários valores.

Observações

A função ItemOrNull é útil juntamente com a função Contains uma vez que a última função retornará o índice para um item no atributo de vários valores.

Retorna um valor Nulo se o índice estiver fora dos limites.

Exemplo

Aderir

Descrição

A função Join usa uma cadeia de caracteres de vários valores e retorna uma cadeia de caracteres de valor único com separador especificado inserido entre cada item.

Sintaxe

str Join(atributo mvstr)

str Join(mvstr attribute, str Delimiter)attribute: Atributo de vários valores contendo strings a serem unidas.

Delimitador: Qualquer cadeia de caracteres, usada para separar as substrings na cadeia de caracteres retornada. Se omitido, o caractere de espaço (" ") é usado. Se Delimitador for uma cadeia de caracteres de comprimento zero ("") ou Nothing, todos os itens na lista serão concatenados sem delimitadores.

Observações

Existe paridade entre as funções Join e Split. A função Join usa uma matriz de cadeias de caracteres e as une usando uma cadeia de caracteres delimitadora, para retornar uma única cadeia de caracteres. A função Split pega uma string e a separa no delimitador, para retornar uma matriz de strings. No entanto, uma diferença fundamental é que Join pode concatenar strings com qualquer string de delimitador, Split só pode separar strings usando um único delimitador de caracteres.

Exemplo

Join([proxyAddresses],",")

Pode retornar: "SMTP:john.doe@contoso.com,smtp:jd@contoso.com"

LCase

Descrição

A função LCase converte todos os caracteres em uma cadeia de caracteres em minúsculas.

Sintaxe

str LCase(valor str)

Observações

Exemplo

LCase("TeSt")

Resultados em "teste".

Esquerda

Descrição

A função Left retorna um número especificado de caracteres da esquerda de uma cadeia de caracteres.

Sintaxe

str Left(str string, num NumChars)string: a string para retornar caracteres de

NumChars: um número que identifica o número de caracteres a serem retornados do início (à esquerda) da cadeia de caracteres

Observações

Uma cadeia de caracteres que contém os primeiros caracteres numChars em cadeia de caracteres.

•Se numChars = 0, retorne a cadeia de caracteres vazia.

•Se numChars < 0, retorne a cadeia de caracteres de entrada.

•Se string for null, retorne string vazia.

Se string contiver menos caracteres do que o número especificado em numChars, uma string idêntica a string (ou seja, contendo todos os caracteres no parâmetro 1) será retornada.

Exemplo

Esquerda("John Doe", 3)

Voltaria "Joh".

Len

Descrição

A função Num retorna o número de caracteres em uma cadeia de caracteres.

Sintaxe

num Len(valor str)

Observações

Exemplo

Len("João Doe")

Voltaria 8

LTrim

Descrição

A função LTrim remove espaços em branco à esquerda de uma cadeia de caracteres.

Sintaxe

str LTrim(valor str)

Observações

Exemplo

LTrim(" Teste ")

Resultados em "Teste"

Média

Descrição

A função Mid retorna um número especificado de caracteres de uma posição especificada em uma cadeia de caracteres.

Sintaxe

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

string: a cadeia de caracteres da qual retornar caracteres

Início: um número que identifica a posição inicial na cadeia de caracteres para retornar caracteres de

NumChars: um número que identifica o número de caracteres a serem retornados da posição na cadeia de caracteres

Observações

Retornar caracteres numChars a partir do início da posição na cadeia de caracteres.

Uma cadeia de caracteres que contém caracteres numChars do início da posição na cadeia de caracteres.

•Se numChars = 0, retorne a cadeia de caracteres vazia.

•Se numChars < 0, retorne a cadeia de caracteres de entrada.

•Se iniciar > o comprimento da cadeia de caracteres, retorne a cadeia de entrada.

•Se iniciar <= 0, retorne a cadeia de entrada.

•Se string for null, retorne string vazia.

Se não houver caracteres numChar restantes na cadeia de caracteres desde o início da posição, tantos caracteres quanto podem ser retornados são retornados.

Exemplo

Mid("João Doe", 3, 5)

Voltaria "hn Do".

Mid("João Doe", 6, 999)

Voltaria "Doe"

Agora

Descrição

A função Now retorna um DateTime especificando a data e hora atuais, de acordo com a data e hora do sistema do seu computador.

Sintaxe

dt Agora()

Observações

Exemplo

NumFromDate

Descrição

A função NumFromDate retorna uma data no formato de data do AD.

Sintaxe

num NumFromDate(valor dt)

Observações

Exemplo

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

Devoluções 129699324000000000

PadLeft

Descrição

A função PadLeft deixa uma cadeia de caracteres para um comprimento especificado usando um caractere de preenchimento fornecido.

Sintaxe

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

string: a string para pad.

length: Um inteiro que representa o comprimento desejado da cadeia de caracteres.

padCharacter: uma cadeia de caracteres que consiste em um único caractere para usar como caractere do pad

Observações

Se o comprimento da string for menor que o comprimento, padCharacter será repetidamente acrescentado ao início (esquerda) da string até que ela tenha um comprimento igual ao comprimento.

padCharacter pode ser um caractere de espaço, mas não pode ser um valor nulo.

Se o comprimento da string for igual ou maior que length, string será retornado inalterado.

Se string tiver um comprimento maior ou igual ao comprimento, uma string idêntica a string será retornada.

Se o comprimento da string for menor que o comprimento, uma nova string do comprimento desejado será retornada contendo string acolchoada com um padCharacter.

Se string for null, a função retornará uma string vazia.

Exemplo

PadLeft("Usuário", 10, "0")

Resultaria em "000000User".

PadRight

Descrição

A função PadRight alfineta uma cadeia de caracteres para um comprimento especificado usando um caractere de preenchimento fornecido.

Sintaxe

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

string: a string para pad.

length: Um inteiro que representa o comprimento desejado da cadeia de caracteres.

padCharacter: uma cadeia de caracteres que consiste em um único caractere para usar como caractere do pad

Observações

Se o comprimento da string for menor que o comprimento, padCharacter será repetidamente acrescentado ao final (à direita) da string até que ela tenha um comprimento igual ao comprimento.

padCharacter pode ser um caractere de espaço, mas não pode ser um valor nulo.

Se o comprimento da string for igual ou maior que length, string será retornado inalterado.

Se string tiver um comprimento maior ou igual ao comprimento, uma string idêntica a string será retornada.

Se o comprimento da string for menor que o comprimento, uma nova string do comprimento desejado será retornada contendo string acolchoada com um padCharacter.

Se string for null, a função retornará uma string vazia.

Exemplo

PadRight("Usuário", 10, "0")

Resultaria em "User000000".

PCase

Descrição

A função PCase converte o primeiro caractere de cada palavra delimitada por espaço em uma cadeia de caracteres em maiúsculas, e todos os outros caracteres são convertidos em minúsculas.

Sintaxe

String PCase(string)

Observações

Exemplo

PCase("TEsT")

Resultados em "Teste".

RandomNum

Descrição

A função RandomNum retorna um número aleatório entre um intervalo especificado.

Sintaxe

num RandomNum(num start, num end)

start: um número que identifica o limite inferior do valor aleatório a gerar

fim: um número que identifica o limite superior do valor aleatório a gerar

Observações

Exemplo

Aleatório(100,999)

poderia retornar 734.

RemoveDuplicates

Descrição

A função RemoveDuplicates usa uma cadeia de caracteres de vários valores e certifique-se de que cada valor seja exclusivo.

Sintaxe

mvstr RemoveDuplicates(atributo mvstr)

Observações

Exemplo

RemoveDuplicates([proxyAddresses])

Retornará um atributo proxyAddress limpo onde todos os valores duplicados foram removidos.

Substituir

Descrição

A função Replace substitui todas as ocorrências de uma cadeia de caracteres por outra cadeia de caracteres.

Sintaxe

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

string: uma cadeia de caracteres para substituir valores.

OldValue: A cadeia de caracteres a ser pesquisada e substituída.

NewValue: A cadeia de caracteres para substituir.

Observações

A função reconhece os seguintes apelidos especiais.

\n – Nova Linha

\r – Retorno de carruagem

\t – Separador

Exemplo

Substituir([endereço],"\r\n",", ")

Substitua CRLF por vírgula e espaço, e pode levar a "One Microsoft Way, Redmond, WA, EUA"

ReplaceChars

Descrição

A função ReplaceChars substitui todas as ocorrências de caracteres encontradas na cadeia de caracteres ReplacePattern.

Sintaxe

str ReplaceChars(str string, str ReplacePattern)

string: uma cadeia de caracteres para substituir caracteres.

ReplacePattern: uma cadeia de caracteres que contém um dicionário com caracteres para substituir. O formato é {source1}:{target1},{source2}:{target2},{sourceN},{targetN} onde source é o caractere para localizar e direcionar a string a ser substituída.

Observações

A função tomará cada ocorrência de fontes definidas e as substituirá pelos alvos.

A origem deve ser exatamente um caractere (unicode).

A origem não pode estar vazia ou ter mais de um caractere (erro de análise).

O alvo pode ter vários caracteres, por exemplo, ö:oe, β:ss.

O alvo pode estar vazio, indicando que o caractere deve ser removido.

A fonte diferencia maiúsculas de minúsculas e deve ser uma correspondência exata.

O , (vírgula) e : (dois pontos) são caracteres reservados e não podem ser substituídos usando esta função.

Espaços e outros caracteres brancos na cadeia de caracteres ReplacePattern são ignorados.

Exemplo

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

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

Devolve Raksmorgas

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

Retorna "ONeil", o único tick é definido para ser removido.

Descrição

A função Right retorna um número especificado de caracteres da direita (fim) de uma cadeia de caracteres.

Sintaxe

str Right(str string, num NumChars)

string: a cadeia de caracteres da qual retornar caracteres

NumChars: um número que identifica o número de caracteres a serem retornados do final (à direita) da cadeia de caracteres

Comentários

Os caracteres NumChars são retornados da última posição da cadeia de caracteres.

Uma cadeia de caracteres que contém os últimos caracteres numChars na cadeia de caracteres.

•Se numChars = 0, retorne a cadeia de caracteres vazia.

•Se numChars < 0, retorne a cadeia de caracteres de entrada.

•Se string for null, retorne string vazia.

Se string contiver menos caracteres do que o número especificado em NumChars, uma string idêntica a string será retornada.

Exemplo

Direita("John Doe", 3)

Voltaria "Doe".

RTrim

Descrição

A função RTrim remove espaços em branco à direita de uma cadeia de caracteres.

Sintaxe

str RTrim(valor str)

Observações

Exemplo

RTrim(" Teste ")

Resultados em "Teste".

Divisão

Descrição

A função Split usa uma cadeia de caracteres separada por um delimitador e a torna uma cadeia de vários valores.

Sintaxe

mvstr Split(valor str, delimitador str)

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

Valor: a cadeia de caracteres com um caractere delimitador para separar.

Delimitador: caractere único a ser usado como delimitador

Limite: número máximo de valores que serão devolvidos

Observações

Exemplo

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

retornaria uma cadeia de caracteres de vários valores com 2 elementos úteis para o atributo proxyAddress

StringFromGuid

Descrição

A função StringFromGuid usa um GUID binário e o converte em uma cadeia de caracteres

Sintaxe

str StringFromGuid(bin GUID)

Comentários

Exemplo

StringFromSid

Descrição

A função StringFromSid converte uma matriz de bytes ou uma matriz de bytes de vários valores contendo um identificador de segurança em uma cadeia de caracteres ou cadeia de caracteres de vários valores.

Sintaxe

str StringFromSid(bin ObjectSID)

mvstr StringFromSid (mvbin ObjectSID)

Observações

Exemplo

Mudar

Descrição

A função Switch é usada para retornar um único valor com base nas condições avaliadas.

Sintaxe

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

Expr: Expressão variante que você deseja avaliar.

Valor: Valor a ser retornado se a expressão correspondente for True.

Observações

A lista de argumentos da função Switch consiste em pares de expressões e valores. As expressões são avaliadas da esquerda para a direita, e o valor associado à primeira expressão a ser avaliada como True é retornado. Se as peças não estiverem emparelhadas corretamente, ocorrerá um erro em tempo de execução.

Por exemplo, se expr1 for True, Switch retornará value1. Se expr-1 for False, mas expr-2 for True, Switch retornará value-2 e assim por diante.

Switch retorna um Nothing se:

  • Nenhuma das expressões é True.

  • A primeira expressão True tem um valor correspondente que é Null.

O Switch avalia todas as expressões, mesmo que retorne apenas uma delas. Por esta razão, deve estar atento a efeitos secundários indesejáveis. Por exemplo, se a avaliação de qualquer expressão resultar em uma divisão por erro zero, ocorrerá um erro.

Value também pode ser a função Error que retornaria uma cadeia de caracteres personalizada.

Exemplo

Switch([cidade] = "Londres", "Inglês", [cidade] = "Roma", "Italiano", [cidade] = "Paris", "Francês", Verdadeiro, Erro("Cidade desconhecida"))

Devolve o idioma falado em algumas das principais cidades, caso contrário devolve um Erro.

Guarnição

Descrição

A função Trim remove espaços em branco à esquerda e à direita de uma cadeia de caracteres.

Sintaxe

str Trim(valor str)

mvstr Trim(valor mvstr)

Observações

Exemplo

Trim(" Teste ")

Resultados em "Teste".

Trim([proxyAddresses])

Removerá espaços à esquerda e à direita para cada valor no atributo proxyAddress.

UCase

Descrição

A função UCase converte todos os caracteres em uma cadeia de caracteres em maiúsculas.

Sintaxe

str UCase(str string)

Observações

Exemplo

UCase("TeSt")

resulta em "TESTE".

Palavra

Descrição

A função Word retorna uma palavra contida em uma cadeia de caracteres, com base em parâmetros que descrevem os delimitadores a serem usados e o número da palavra a ser retornado.

Sintaxe

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

string: a cadeia de caracteres da qual retornar uma palavra

WordNumber: um número que identifica qual número de palavra deve ser retornado

delimitadores: uma cadeia de caracteres que representa o(s) delimitador(es) que deve ser usado para identificar palavras

Observações

Cada cadeia de caracteres em cadeia separada por um dos caracteres em delimitadores são identificados como palavras.

•Se o número < 1, volte a cadeia vazia.

•Se string for null, retorne string vazia.

Se string contiver menos de palavras numéricas ou string não contiver palavras identificadas por delímetros, uma string vazia será retornada.

Exemplo

Palavra("A raposa castanha rápida",3," ")

Voltaria "castanho"

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

Voltaria "tem"

Ver também

Conceitos

de Sincronização do Ative Directory do Azure