Update-HybridConfiguration
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.
Use o cmdlet Update-HybridConfiguration para definir as credenciais usadas para atualizar o objeto de configuração híbrida.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Update-HybridConfiguration
-OnPremisesCredentials <PSCredential>
-TenantCredentials <PSCredential>
[-Confirm]
[-DomainController <Fqdn>]
[-ForceUpgrade]
[-SuppressOAuthWarning]
[-WhatIf]
[<CommonParameters>]
Description
Para executar esse cmdlet, você precisa ter permissões. Embora este tópico 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
$OnPremisesCreds = Get-Credential
$TenantCreds = Get-Credential
Update-HybridConfiguration -OnPremisesCredentials $OnPremisesCreds -TenantCredentials $TenantCreds
Este exemplo define as credenciais usadas para atualizar o objeto de configuração híbrida e conectar-se à organização Microsoft 365 para empresas.
Use o primeiro comando para especificar suas credenciais de organização locais. Por exemplo, execute esse comando e insira <domain>\admin@contoso.com
e a senha associada na caixa de diálogo Solicitação de Credencial Windows PowerShell resultante.
Use o segundo comando para especificar suas credenciais de organização Microsoft 365. Por exemplo, execute esse comando e insira admin@contoso.onmicrosoft.com
e a senha da conta associada na caixa de diálogo Solicitação de Credencial Windows PowerShell resultante.
Use o último comando para definir as credenciais usadas para atualizar o objeto de configuração híbrida e conectar-se à organização Microsoft 365.
Parâmetros
-Confirm
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false
. - A maioria dos outros cmdlets (por exemplo, cmdlets 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 confirmar o comando antes de continuar.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Este parâmetro está disponível somente no Exchange local.
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.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ForceUpgrade
O comutador ForceUpgrade suprime a mensagem de confirmação que aparece se o objeto foi criado em uma versão anterior do Exchange. Não é preciso especificar um valor com essa opção.
Esse prompt de confirmação é exibido somente quando a versão existente do objeto HybridConfiguration Active Directory é o Exchange 2010.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-OnPremisesCredentials
O parâmetro OnPremisesCredentials especifica a Active Directory local conta e a senha usadas para configurar o objeto de configuração híbrida. Essa conta deve ser um membro do grupo de funções gerenciamento de organização.
Um valor para esse parâmetro requer o cmdlet Get-Credential. Para pausar o comando e receber uma solicitação de credenciais, use o valor (Get-Credential)
. Ou, antes de executar esse comando, armazene as credenciais em uma variável (por exemplo, $cred = Get-Credential
) e, em seguida, use o nome da variável ($cred
) para esse parâmetro. Para saber mais, confira Obter credencial.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SuppressOAuthWarning
Esse parâmetro está reservado para uso interno da Microsoft.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TenantCredentials
O parâmetro TenantCredentials especifica a Microsoft conta da organização 365 e a senha usadas para configurar o objeto de configuração híbrida. Geralmente, essa é a conta de administrador atribuída quando a organização Microsoft 365 foi criada. Essa conta deve ser um membro da função de administrador global.
Um valor para esse parâmetro requer o cmdlet Get-Credential. Para pausar o comando e receber uma solicitação de credenciais, use o valor (Get-Credential)
. Ou, antes de executar esse comando, armazene as credenciais em uma variável (por exemplo, $cred = Get-Credential
) e, em seguida, use o nome da variável ($cred
) para esse parâmetro. Para saber mais, confira Obter credencial.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
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.