Set-ServerComponentState
Este cmdlet está disponível somente no Exchange local.
Utilize o cmdlet Set-ServerComponentState para configurar e atualizar os componentes e pontos finais do Microsoft Exchange nos servidores que especificar.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Set-ServerComponentState
[-Identity] <ServerIdParameter>
-Component <String>
-Requester <String>
-State <ServiceState>
[-Confirm]
[-DomainController <Fqdn>]
[-LocalOnly]
[-RemoteOnly]
[-TimeoutInSeconds <Int32>]
[-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
Set-ServerComponentState -Identity MailboxServer01 -Component UMCallRouter -Requester Maintenance -State ActiveO exemplo a seguir define o estado do componente de Unificação de Mensagens (UM) para Ativo, conforme solicitado pelo modo de manutenção.
Exemplo 2
Set-ServerComponentState -Identity Exch5 -Component ServerWideOffline -State Inactive -Requester Maintenance
Set-ServerComponentState -Identity Exch5 -Component ServerWideOffline -State Active -Requester MaintenanceEste exemplo prepara o servidor para manutenção, como instalar uma Atualização de Segurança ou Atualização Cumulativa.
O primeiro comando altera o estado de todos os componentes do servidor para Inativo.
O segundo comando altera o estado para Ativo após a manutenção terminar (obrigatório).
Observação
Por predefinição, os serviços Microsoft Exchange IMAP4 e Microsoft Exchange POP3 param se os componentes e PopProxy relacionados ImapProxy estiverem no estado Inativo. Os serviços podem ter de ser iniciados manualmente depois de os componentes relacionados ImapProxy e PopProxy serem alterados para o estado Ativo.
Parâmetros
-Component
O parâmetro Component especifica o componente ou ponto de extremidade cujo estado você deseja definir.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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, 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 confirmar o comando antes de continuar.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
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.
O parâmetro DomainController não é compatível com os servidores de Transporte do Microsoft Edge. Um servidor de Transporte do Microsoft Edge usa a instância local dos Serviços AD LDS para ler e gravar dados.
| Tipo: | Fqdn |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
O parâmetro Identity especifica o servidor Exchange onde pretende executar este comando. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:
- Nome
- FQDN
- DN (nome diferenciado)
- DN Herdado do Exchange
| Tipo: | ServerIdParameter |
| Cargo: | 1 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LocalOnly
O comutador LocalOnly especifica que as alterações são escritas apenas no registo do servidor Exchange e não no Active Directory. Não é preciso especificar um valor com essa opção.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RemoteOnly
O comutador RemoteOnly especifica que as alterações são escritas apenas no Active Directory e não no registo do servidor Exchange. Não é preciso especificar um valor com essa opção.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Requester
O parâmetro Requester especifica o sistema solicitando essa mudança de estado. Os valores válidos são:
- HealthAPI
- Manutenção
- À margem
- Funcional
- Implantação
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-State
O parâmetro State especifica o estado que você deseja para esse componente. Os valores válidos são:
- Ativo
- Inativo
- Drenagem
| Tipo: | ServiceState |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TimeoutInSeconds
Esse parâmetro está reservado para uso interno da Microsoft.
| Tipo: | Int32 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.