Compartilhar via


Set-OutlookProvider

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-06-28

Use o cmdlet Set-OutlookProvider para definir as configurações globais específicas com o atributo msExchOutlookProvider no objeto msExchAutoDiscoverConfig, do serviço de diretório do Active Directory.

Sintaxe

Set-OutlookProvider -Identity <OutlookProviderIdParameter> [-CertPrincipalName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-Server <String>] [-TTL <Int32>] [-WhatIf [<SwitchParameter>]]

Set-OutlookProvider [-CertPrincipalName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <OutlookProvider>] [-Name <String>] [-Server <String>] [-TTL <Int32>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Set-OutlookProvider cria as configurações globais para o serviço de Descoberta Automática. Define o objeto AutoDiscoverConfig no objeto Configurações globais do Active Directory e define os atributos especificados nos parâmetros listados na seção Parâmetros.

Para executar o cmdlet Set-OutlookProvider, você deve usar uma conta à qual esteja delegado o seguinte:

  • Função Administrador da Organização do Exchange

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário(s) Tipo Descrição

Identity

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.OutlookProviderIdParameter

O parâmetro Identity especifica o valor ADIDParameter do protocolo MAPI para o qual você deseja definir configurações globais.

CertPrincipalName

Opcional

System.String

O parâmetro CertPrincipalName especifica o nome principal do certificado SSL (Secure Sockets Layer) necessário para se conectar ao Exchange de um local externo.

Este parâmetro é usado apenas para clientes do Microsoft Outlook em Qualquer Lugar. 

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que recupera dados do Active Directory, inclua o parâmetro DomainController no comando.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.OutlookProvider

O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.

Name

Opcional

System.String

Use o parâmetro Name para especificar um nome comum para o objeto Configuração do Provedor do Outlook. Pode ser um nome para fácil identificação.

Server

Opcional

System.String

Use o parâmetro Server para especificar o servidor de email a ser usado para clientes do Outlook em Qualquer Lugar.

TTL

Opcional

System.Int32

O parâmetro TTL especifica a duração (em horas) em que as configurações especificadas ficam válidas.

Se um valor for especificado, as configurações serão redescobertas pela Descoberta Automática após a duração especificada com esse parâmetro. Um valor igual a 0 indica que nenhuma redescoberta será necessária. O valor padrão é 1 hora.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

Neste exemplo, o comando Set-OutlookProvider é usado para alterar a duração em que as configurações de descoberta automática ficam válidas para msExchAutoDiscoverConfig do Provedor do Outlook.

Set-OutlookProvider -Identity msExchAutoDiscoverConfig -TTL 2