New-DatabaseAvailabilityGroup
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet New-DatabaseAvailabilityGroup para criar um novo grupo de disponibilidade de banco de dados (DAG).
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
New-DatabaseAvailabilityGroup
[-Name] <String>
[-ActivityState <ActivityStateOption>]
[-Confirm]
[-DagConfiguration <DatabaseAvailabilityGroupConfigurationIdParameter>]
[-DatabaseAvailabilityGroupIpAddresses <IPAddress[]>]
[-DomainController <Fqdn>]
[-FileSystem <FileSystemMode>]
[-ThirdPartyReplication <ThirdPartyReplicationMode>]
[-WhatIf]
[-WitnessDirectory <NonRootLocalLongFullPath>]
[-WitnessServer <FileShareWitnessServerName>]
[<CommonParameters>]
Description
Ao criar um DAG, você precisa especificar um nome de computador válido para o DAG que não ultrapasse 15 caracteres que seja exclusivo dentro da floresta do Active Directory. Além disso, cada DAG é configurado com um servidor testemunha e um diretório testemunha. O servidor testemunha e seu diretório só são usados para fins de quorum, quando houver um número par de membros no DAG. Você não precisa criar o diretório testemunha com antecedência. O Exchange cria e protege automaticamente o diretório para você no servidor testemunha. O diretório não deve ser usado para qualquer outro fim que não seja do servidor testemunha do DAG.
Os requisitos do servidor de testemunha são os seguintes:
- O servidor testemunha não pode ser um membro do DAG.
- O servidor testemunha deve estar executando o sistema operacional Windows Server 2008 ou posterior.
- Um único servidor pode servir como testemunha de múltiplos DAGs; no entanto, cada DAG exige o seu próprio diretório testemunha.
As seguintes combinações de opções e comportamentos estão disponíveis:
- Você pode especificar um nome para o DAG, o servidor testemunha que deseja utilizar e o diretório a ser criado e compartilhado no servidor testemunha.
- Você pode especificar um nome para o DAG e o servidor testemunha que deseja utilizar. Nesse cenário, a tarefa cria o diretório padrão no servidor testemunha especificado.
Se o servidor-testemunha especificado não for um servidor Exchange, você precisará adicionar o USG (grupo de segurança universal) do Subsistema Confiável do Exchange ao grupo de Administradores local no servidor testemunha. Se o servidor testemunha for um servidor de diretório, você precisará adicionar o USG do Subsistema Confiável do Exchange ao grupo Builtin\Administradores. Estas permissões de segurança são necessárias para assegurar que o Exchange possa criar um diretório e compartilhar no servidor testemunha quando necessário.
No Windows Server 2012 R2 ou posterior, um DAG é criado sem um ponto de acesso administrativo de cluster por padrão. Nesse cenário, você não precisa fornecer todos os endereços IP ao DAG. No entanto, em todas as versões com suporte do Windows, você tem a opção de atribuir endereços IP estáticos ao DAG usando o parâmetro DatabaseAvailabilityGroupIpAddresses. Se você especificar Qualquer ou 0.0.0.0, a tarefa tentará usar o Protocolo de Configuração de Host Dinâmico (DHCP) para obter endereços IP. Se você omitir esse parâmetro ou configurar o parâmetro com um valor Nenhum ou 255.255.255.255, o DAG não terá um ponto de acesso administrativo do cluster.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
New-DatabaseAvailabilityGroup -Name DAG1 -WitnessServer SERVER1 -WitnessDirectory C:\DAG1
Este exemplo cria um DAG chamado DAG1, configurado para usar um servidor testemunha do SERVER1 e um diretório local de C:\DAG1. Este exemplo requer o Windows Server 2012 R2 ou posterior.
Exemplo 2
New-DatabaseAvailabilityGroup -Name DAG2 -WitnessServer SERVER2 -DatabaseAvailabilityGroupIpAddresses ([])::Any
Este exemplo cria o DAG chamado DAG2 com um servidor testemunha denominado SERVER2. O sistema seleciona automaticamente um servidor Exchange no mesmo site que o DAG para usar como servidor testemunha. O DAG2 está configurado para usar DHCP para o endereço IP do DAG.
Exemplo 3
New-DatabaseAvailabilityGroup -Name DAG3 -WitnessServer SERVER1 -WitnessDirectory C:\DAG3 -DatabaseAvailabilityGroupIpAddresses 10.0.0.8,192.168.0.8
Este exemplo cria um DAG denominado DAG3. O DAG3 está configurado para usar o SERVER1 para o servidor testemunha e um diretório testemunha no SERVER1 do C:\DAG3. O DAG3 recebe vários endereços IP estáticos porque a rede MAPI para o DAG contém várias sub-redes (10.0.0.x e 192.168.0.x).
Parâmetros
-ActivityState
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | ActivityStateOption |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DagConfiguration
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | DatabaseAvailabilityGroupConfigurationIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DatabaseAvailabilityGroupIpAddresses
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro DatabaseAvailabilityGroupIpAddresses especifica um ou mais endereços IPv4 estáticos para o DAG quando um servidor de Caixa de Correio é adicionado a um DAG. Se você especificar o valor Any ou 0.0.0.0, o sistema tentará conceder um ou mais endereços IPv4 de um servidor DHCP para atribuir ao DAG. Se você não usar esse parâmetro, ou se especificar o valor 255.255.255.255 ou None, o DAG será criado sem um ponto de acesso administrativo do cluster.
Propriedades do parâmetro
| Tipo: | IPAddress[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-FileSystem
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro FileSystem especifica o sistema de arquivos usado para o DAG. Os valores válidos são:
- NTFS
- ReFS
Propriedades do parâmetro
| Tipo: | FileSystemMode |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro Name especifica um nome único para o novo DAG de até 15 caracteres. O nome usado não deve entrar em conflito com nenhum nome de computador na organização.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ThirdPartyReplication
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro ThirdPartyReplication especifica a configuração e a habilitação de um DAG para usar a replicação que não é da Microsoft e aproveita a API de Replicação de Terceiros do Exchange em vez da replicação contínua interna. Os valores válidos são Enabled e Disabled. Depois de habilitado, este modo não pode ser alterado.
Propriedades do parâmetro
| Tipo: | ThirdPartyReplicationMode |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WitnessDirectory
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro WitnessDirectory especifica o nome do diretório no servidor de testemunha usado para armazenar dados de testemunha de compartilhamento de arquivo. O diretório e o compartilhamento devem ser hospedados em um servidor Exchange diferente de qualquer um dos servidores de Caixa de Correio no DAG. Isso permite que um administrador do Exchange mantenha o controle operacional sobre o diretório. O diretório especificado não pode ser usado por outros DAGs nem para qualquer finalidade diferente que não seja para o servidor testemunha. Se você não usar esse parâmetro, o diretório testemunha padrão será usado.
Propriedades do parâmetro
| Tipo: | NonRootLocalLongFullPath |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WitnessServer
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro WitnessServer especifica o nome de um servidor usado como testemunha de quorum quando houver um número par de membros no DAG. O servidor especificado não pode ser um membro do DAG configurado para usá-lo. Recomendamos um servidor de caixa de correio autônomo ou um servidor de caixa de correio em outro DAG.
Propriedades do parâmetro
| Tipo: | FileShareWitnessServerName |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.