Set-ADServerSettings
Este cmdlet está disponível somente no Exchange local.
Utilize o cmdlet Set-ADServerSettings para gerir o ambiente do Active Directory Domain Services (AD DS) na sessão atual da Shell de Gestão do Exchange. O cmdlet Set-ADServerSettings substitui a variável de sessão AdminSessionADSettings que foi utilizada no Exchange Server 2007.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Instance
Set-ADServerSettings
-RunspaceServerSettings <RunspaceServerSettingsPresentationObject>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
FullParams
Set-ADServerSettings
[-ConfigurationDomainController <Fqdn>]
[-PreferredGlobalCatalog <Fqdn>]
[-RecipientViewRoot <String>]
[-SetPreferredDomainControllers <MultiValuedProperty>]
[-ViewEntireForest <Boolean>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
SingleDC
Set-ADServerSettings
[[-PreferredServer] <Fqdn>]
[-RecipientViewRoot <String>]
[-ViewEntireForest <Boolean>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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-ADServerSettings -RecipientViewRoot "contoso.com/Marketing Users"
Este exemplo define o escopo do destinatário para a UO Marketing Users no domínio contoso.com da sessão atual.
Exemplo 2
Set-ADServerSettings -ViewEntireForest $true -PreferredGlobalCatalog gc1.contoso.com
Este exemplo define o escopo da sessão atual como toda a floresta e designa gc1.contoso.com como o servidor de catálogo global preferido.
Parâmetros
-ConfigurationDomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro ConfigurationDomainController especifica o nome de domínio completamente qualificado (FQDN) do controlador de domínio de configuração a utilizar para ler as informações de configuração do Exchange nesta sessão.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FullParams
| 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
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.
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 |
-PreferredGlobalCatalog
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro PreferredGlobalCatalog especifica o FQDN do servidor do catálogo global a ser usado na leitura das informações de destinatário nessa sessão.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FullParams
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PreferredServer
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro PreferredServer especifica o FQDN do controlador de domínio a ser usado nesta sessão.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
SingleDC
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RecipientViewRoot
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro RecipientViewRoot especifica a UO (unidade organizacional) a ser incluída no escopo de destinatário dessa sessão. Quando um escopo de destinatário é especificado com esse parâmetro, apenas os destinatários incluídos no escopo são retornados. Para especificar uma UO, utilize a sintaxe <FQDN of ___domain>/<OU tree>.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
SingleDC
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
FullParams
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RunspaceServerSettings
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro RunspaceServerSettings especifica se se deve analisar um objeto de configuração inteiro para o comando ser processado. Esse parâmetro é útil em scripts em que um objeto inteiro deve ser passado para o comando.
Propriedades do parâmetro
| Tipo: | RunspaceServerSettingsPresentationObject |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Instance
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-SetPreferredDomainControllers
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro SetPreferredDomainControllers especifica a lista de controladores de domínio utilizados para ler informações do Active Directory nesta sessão. O FQDN dos controladores de domínio deve ser especificado. Separe vários controladores de domínio por vírgulas.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FullParams
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ViewEntireForest
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro ViewEntireForest especifica se todos os objetos da floresta são exibidos e gerenciados nessa sessão. Os valores válidos são $true e $false.
Quando o valor $true é especificado, o valor armazenado no parâmetro RecipientViewRoot é removido e todos os destinatários na floresta podem ser exibidos e gerenciados.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
SingleDC
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
FullParams
| 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
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.
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 |
CommonParameters
Este cmdlet suporta os 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.