---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# MIDServerFinder - Global

# MIDServerFinder - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

A inclusão de script MIDServerFinder fornece métodos para encontrar uma lista de MID Servers para endereços IP especificados.

Use em scripts de servidor para obter a lista MID Server.

## MIDServerFinder - MIDServerFinder() {#ariaid-title2}

Cria uma instância de MIDServerFinder.
{#r_MSFD-MIDServerFinder__table_ikc_bfl_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

{#r_MSFD-MIDServerFinder__table_ikc_bfl_zt} {#r_MSFD-MIDServerFinder__table_jkc_bfl_zt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 2. Retorna]

{#r_MSFD-MIDServerFinder__table_jkc_bfl_zt}

## MIDServerFinder - getMIDServers() {#ariaid-title3}

Obtém os nomes dos servidores MID disponíveis para um determinado intervalo e capacidade.
{#r_MSFD-getMIDServers__table_jff_pjl_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 3. Parâmetros]

{#r_MSFD-getMIDServers__table_jff_pjl_zt} {#r_MSFD-getMIDServers__table_kff_pjl_zt__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Uma matriz de nomes de MID server. Se nenhum MID Server estiver disponível, retornará uma matriz vazia. |
[Tabela 4. Retorna]

{#r_MSFD-getMIDServers__table_kff_pjl_zt}  

    var msf = new MIDServerFinder();
    msf.setRanges('10.10.10.1-10.10.11.254');
    var msnames = msf.getMIDServers();
     
    for(var i=0; i<msnames.length; i++) {
      gs.print(msnames[i]);
    };

## MIDServerFinder -- getMIDServersBySysId() {#ariaid-title4}

Obtém os sys_ids dos MID Servers disponíveis para um determinado intervalo e capacidade.
{#r_MSFD-getMIDServersBySysId__table_rlq_z3l_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 5. Parâmetros]

{#r_MSFD-getMIDServersBySysId__table_rlq_z3l_zt} {#r_MSFD-getMIDServersBySysId__table_slq_z3l_zt__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Uma matriz de sys_ids do MID Server. Se nenhum MID Server estiver disponível, retornará uma matriz vazia. |
[Tabela 6. Retorna]

{#r_MSFD-getMIDServersBySysId__table_slq_z3l_zt}  

    var msf = new MIDServerFinder();
    msf.setRanges('10.10.10.1-10.10.11.254');
    var msids = msf.getMIDServersBySysId();
     
    for(var i=0; i<msids.length; i++) {
      gs.print(msids[i]);
    };

## MIDServerFinder -- getStatusMessage() {#ariaid-title5}

Obtém o estado da operação do localizador.
{#r_MSFD-getStatusMessage__table_brz_zjl_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 7. Parâmetros]

{#r_MSFD-getStatusMessage__table_brz_zjl_zt} {#r_MSFD-getStatusMessage__table_crz_zjl_zt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | A mensagem de status |
[Tabela 8. Retorna]

{#r_MSFD-getStatusMessage__table_crz_zjl_zt}  

    var msf = new MIDServerFinder();
    gs.print(msf.getStatusMessage());

## MIDServerFinder - setActive(Booliano sinalizador) {#ariaid-title6}

Define se deve procurar MID Servers ativos ou inativos. Por padrão, as pesquisas são para MID Servers ativos, a menos que inativo seja especificado por este método.
{#r_MSFD-setActive_B__table_ipq_33l_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| sinalizador | Booliano | Se verdadeiro, procure MID Servers inativos. Se falso, não procure MID Servers inativos. |
[Tabela 9. Parâmetros]

{#r_MSFD-setActive_B__table_ipq_33l_zt} {#r_MSFD-setActive_B__table_jpq_33l_zt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 10. Retorna]

{#r_MSFD-setActive_B__table_jpq_33l_zt}  

    var msf = new MIDServerFinder();
    msf.setActive('true');

## MIDServerFinder - setCapabilities(capacidades da matriz) {#ariaid-title7}

Define as tecnologias a serem procuradas.
{#r_MSFD-setCapabilities_A__table_qqt_nhl_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Capacidades | Matriz | Contém uma lista de capacidades, por exemplo - `capacidades = ["ssh","wmi","snmp",{"os_domain":"disco"},{"phase":1}];` |
[Tabela 11. Parâmetros]

{#r_MSFD-setCapabilities_A__table_qqt_nhl_zt} {#r_MSFD-setCapabilities_A__table_rqt_nhl_zt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 12. Retorna]

{#r_MSFD-setCapabilities_A__table_rqt_nhl_zt}  

    var msf = new MIDServerFinder();
    msf.setRanges('10.10.10.1-10.10.11.254');
    var capab = ["ssh","wmi","snmp"];
    msf.setCapabilities(capab);

## MIDServerFinder - setDebug(Booliano onOrOff) {#ariaid-title8}

Ativa ou desativa a depuração.
{#r_MSFD-setDebug_B__table_u1w_3kl_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| onOrOff | Booliano | Verdadeiro para ativar a depuração; falso para desativar a depuração. |
[Tabela 13. Parâmetros]

{#r_MSFD-setDebug_B__table_u1w_3kl_zt} {#r_MSFD-setDebug_B__table_v1w_3kl_zt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 14. Retorna]

{#r_MSFD-setDebug_B__table_v1w_3kl_zt}  

    var msf = new MIDServerFinder();
    msf.setDebug('true');

## MIDServerFinder - setRanges(Intervalos de cadeia de caracteres) {#ariaid-title9}

Define o intervalo de endereços IP a serem pesquisados.
{#r_MSFD-setRanges_S__table_uvk_jfl_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| intervalos | Cadeia de caracteres | Uma lista separada por vírgulas em um desses formatos. * Endereços IP (10.10.10.1, 10.10.10.2) * Redes IP (10.10.10.0/23) * Intervalos de IP (10.10.10.1-10.10.11.254) {#r_MSFD-setRanges_S__ul_ipr_pfl_zt} |
[Tabela 15. Parâmetros]

{#r_MSFD-setRanges_S__table_uvk_jfl_zt} {#r_MSFD-setRanges_S__table_vvk_jfl_zt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 16. Retorna]

{#r_MSFD-setRanges_S__table_vvk_jfl_zt}  

    var msf = new MIDServerFinder();
    msf.setRanges('10.10.10.1-10.10.11.254');

## MIDServerFinder -- setRangesByIPOrHostname(cadeia de caracteres ipOrHostname) {#ariaid-title10}

Determina se a entrada é um único IP ou um nome de host e passa o IP ou vários IPs para o método setRanges().
Se o valor de ipOrHostname for um endereço IP, ele será passado para o método setRanges(). Se o valor for um nome de host, pesquisaremos a tabela DNS (cmdb_ip_address_dns_name) para tentar resolver o nome do host. O resultado, um IP ou vários IPs, é passado para o método setRanges().
{#r_MSFD-setRangesByIPOrHname_S__table_rnw_zfl_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ipOrHostname | Cadeia de caracteres | O endereço IP, o intervalo de IPs ou o nome do host. |
[Tabela 17. Parâmetros]

{#r_MSFD-setRangesByIPOrHname_S__table_rnw_zfl_zt} {#r_MSFD-setRangesByIPOrHname_S__table_snw_zfl_zt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 18. Retorna]

{#r_MSFD-setRangesByIPOrHname_S__table_snw_zfl_zt}  

    var msf = new MIDServerFinder();
    msf.setRangesByIPOrHostname('10.10.10.1-10.10.11.254');