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