

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Ingressando SVMs no Active Directory usando a API Console de gerenciamento da AWS, AWS CLI e
<a name="join-svm-to-ad"></a>

Aplique o procedimento a seguir para associar uma SVM existente a um Active Directory. Nesse procedimento, a SVM ainda *não* está associada a um Active Directory.

**Para associar uma SVM a um Active Directory (Console de gerenciamento da AWS)**

1. Abra o FSx console da Amazon em [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/).

1. Escolha a SVM que deseja associar a um Active Directory:
   + No painel de navegação à esquerda, escolha **Sistemas de arquivos** e, em seguida, escolha o sistema de arquivos do ONTAP com a SVM que você deseja atualizar.
   + Escolha a guia **Máquinas virtuais de armazenamento**.

     Ou
   + Para exibir uma lista de todos os disponíveis SVMs, no painel de navegação esquerdo, expanda **ONTAP** e escolha **Armazenamento de máquinas virtuais**. Uma lista de tudo SVMs em sua conta no Região da AWS é exibida.

   Selecione na lista a SVM que deseja associar a um Active Directory.

1. No canto superior direito do painel **Resumo** da SVM, escolha **Ações** > **Ingressar/atualizar o Active Directory**. A janela **Integrar a SVM a um Active Directory** é exibida.

1. Insira as seguintes informações para o Active Directory ao qual você está associando a SVM:
   + O **Nome NetBIOS** do objeto de computador do Active Directory que será criado para a SVM. Trata-se do nome da SVM no Active Directory, que deve ser exclusivo no Active Directory. Não use o nome NetBIOS do domínio inicial. O nome NetBIOS não pode ter mais de 15 caracteres.
   + O **nome de domínio totalmente qualificado (FQDN)** do Active Directory. O nome do domínio não pode ter mais de 255 caracteres.
   + **Endereços IP do servidor DNS** — Os IPv6 endereços IPv4 ou dos servidores DNS do seu domínio.
   + **Credenciais da conta de serviço**: escolha como fornecer as credenciais da sua conta de serviço:
     + **Opção 1**: ARN AWS Secrets Manager secreto - O segredo que contém o nome de usuário e a senha de uma conta de serviço no seu domínio do Active Directory. Para obter mais informações, consulte [Armazenando credenciais do Active Directory usando AWS Secrets Manager](self-managed-AD-best-practices.md#bp-store-ad-creds-using-secret-manager).
     + **Opção 2**: credenciais em texto não criptografado
       + **Nome de usuário da conta de serviço**: o nome de usuário da conta de serviço no seu Microsoft Active Directory existente. Não inclua um prefixo ou sufixo de domínio. Por exemplo, para `EXAMPLE\ADMIN`, use apenas `ADMIN`.
       + **Senha da conta de serviço**: a senha da conta de serviço.
       + **Confirmar senha**: a senha da conta de serviço.
     + **Gerenciado no Secrets Manager** (padrão): forneça o ARN de um segredo do Secrets Manager que contém as credenciais da sua conta de serviço. O segredo deve conter os pares de valores-chave `CUSTOMER_MANAGED_ACTIVE_DIRECTORY_USERNAME` e `CUSTOMER_MANAGED_ACTIVE_DIRECTORY_PASSWORD`.
     + (Opcional) **Unidade organizacional (UO)**: o nome do caminho distinto da unidade organizacional à qual você deseja unir sua SVM.
     + **Grupo de administradores delegado do sistema de arquivos**: o nome do grupo no Active Directory que pode administrar o sistema de arquivos.

       Se você estiver usando AWS Managed Microsoft AD, deverá especificar um grupo como Administradores AWS Delegados, FSx Administradores AWS Delegados ou um grupo personalizado com permissões delegadas à OU.

       Se você estiver fazendo a associação com um Active Directory autogerenciado, use o nome do grupo em seu Active Directory. O grupo padrão é `Domain Admins`.

1. Escolha **Ingressar no Active Directory** para associar a SVM ao Active Directory usando a configuração que você forneceu.

**Para unir uma SVM a um Active Directory (AWS CLI)**
+ Para unir um FSx for ONTAP SVM a um Active Directory, use o comando [update-storage-virtual-machine](https://docs.aws.amazon.com/cli/latest/reference/fsx/update-storage-virtual-machine.html)CLI (ou a operação de [UpdateStorageVirtualMachine](https://docs.aws.amazon.com/fsx/latest/APIReference/API_UpdateStorageVirtualMachine.html)API equivalente), conforme mostrado no exemplo a seguir.

  ```
  aws fsx update-storage-virtual-machine \
    --storage-virtual-machine-id svm-abcdef0123456789a\
    --active-directory-configuration SelfManagedActiveDirectoryConfiguration='{DomainName="corp.example.com", \
      OrganizationalUnitDistinguishedName="OU=FileSystems,DC=corp,DC=example,DC=com",\
      FileSystemAdministratorsGroup="FSxAdmins",UserName="FSxService",\
      Password="password", \
      DnsIps=["10.0.1.18"]}',NetBiosName=amznfsx12345
  ```

  Depois de criar com sucesso a máquina virtual de armazenamento, a Amazon FSx retorna sua descrição no formato JSON, conforme mostrado no exemplo a seguir.

  ```
  {
    "StorageVirtualMachine": {
      "ActiveDirectoryConfiguration": {
        "NetBiosName": "amznfsx12345",
        "SelfManagedActiveDirectoryConfiguration": {
          "UserName": "Admin",
          "DnsIps": [
            "10.0.1.3",
            "10.0.91.97"
          ],
          "OrganizationalUnitDistinguishedName": "OU=Computers,OU=customer-ad,DC=customer-ad,DC=example,DC=com",
          "DomainName": "customer-ad.example.com"
        }
      }
      "CreationTime": 1625066825.306,
      "Endpoints": {
        "Management": {
          "DnsName": "svm-abcdef0123456789a.fs-0123456789abcdef0.fsx.us-east-1.amazonaws.com",
          "IpAddressses": ["198.19.0.4"]    
        },
        "Nfs": {
          "DnsName": "svm-abcdef0123456789a.fs-0123456789abcdef0.fsx.us-east-1.amazonaws.com",
          "IpAddressses": ["198.19.0.4"]    
        },
        "Smb": {
          "DnsName": "amznfsx12345",
          "IpAddressses": ["198.19.0.4"]        
        },
        "SmbWindowsInterVpc": {
          "IpAddressses": ["198.19.0.5", "198.19.0.6"]    
        },
        "Iscsi": {
          "DnsName": "iscsi.svm-abcdef0123456789a.fs-0123456789abcdef0.fsx.us-east-1.amazonaws.com",
          "IpAddressses": ["198.19.0.7", "198.19.0.8"]    
        }
      },
      "FileSystemId": "fs-0123456789abcdef0",
      "Lifecycle": "CREATED",
      "Name": "vol1",
      "ResourceARN": "arn:aws:fsx:us-east-1:123456789012:storage-virtual-machine/fs-0123456789abcdef0/svm-abcdef0123456789a",
      "StorageVirtualMachineId": "svm-abcdef0123456789a",
      "Subtype": "default",
      "Tags": [],
  
    }
  }
  ```