Reset-ProvisioningCache

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Este cmdlet está disponível somente no Exchange local.

O cmdlet Reset-ProvisioningCache limpa o cache de provisionamento Windows PowerShell de objetos do Active Directory usados com frequência. Este cmdlet é usado apenas para fins de diagnóstico.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Reset-ProvisioningCache
     [-Server] <Fqdn>
     -Application <String>
     [-GlobalCache]
     [-CacheKeys <MultiValuedProperty>]
     [-Confirm]
     [-WhatIf]
     [<CommonParameters>]

Reset-ProvisioningCache
     [-Server] <Fqdn>
     -Application <String>]
     [-CurrentOrganization]
     [-Organizations <MultiValuedProperty>]
     [-CacheKeys <MultiValuedProperty>]
     [-Confirm]
     [-WhatIf]
     [<CommonParameters>]

Description

O cmdlet Reset-ProvisioningCache é apenas para fins diagnósticos e é usado raramente. Os administradores do Exchange precisam executar esse cmdlet somente se links ou propriedades incorretos forem carimbados em destinatários recém-provisionados, o que pode ser causado por dados obsoletos no cache de provisionamento. Esta é uma ocorrência rara, pois o cache de provisionamento possui uma lógica de notificação de invalidação:

O cmdlet Reset-ProvisioningCache limpa o cache de provisionamento Windows PowerShell de objetos do Active Directory usados com frequência. Para reduzir as solicitações do Active Directory, um cache de provisionamento é inicializado em cada Windows PowerShell runspace e é usado para armazenar em cache objetos comuns que são usados com frequência por cmdlets e manipuladores de provisionamento. Durante a execução do cmdlet do Exchange, o cache de provisionamento carrega objetos de configuração do Active Directory para ajudar a executar um cmdlet. Por exemplo, quando você cria uma caixa de correio, o cmdlet New-Mailbox obtém propriedades do Active Directory. Ao executar cmdlets, objetos de configuração, como contêineres de banco de dados, grupos de funções administrativas e LegacyDNs, são recuperados do Active Directory. Como esses tipos de objetos são estáveis e não são alterados por meses ou anos após serem criados, eles são armazenados no cache de provisionamento usado por Windows PowerShell. Isso aumenta a eficiência do provisionamento e melhora significativamente o desempenho do cmdlet.

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

Reset-ProvisioningCache -Server EXSRV1.contoso.com -Application Powershell -GlobalCache

Este exemplo redefine o cache de provisionamento para Windows PowerShell em execução no servidor EXSRV1.contoso.com em uma organização local do Exchange e especifica que todas as chaves de cache são desmarcadas.

Exemplo 2

Reset-ProvisioningCache -Application Powershell-Proxy -Server datacenter1.adatum.com -GlobalCache

Este exemplo é executado em uma implantação de vários locatários por um administrador de data center para redefinir o cache de provisionamento para Windows PowerShell para o locatário adatum.com e limpar todas as chaves de cache.

Parâmetros

-Application

O parâmetro Application especifica o aplicativo administrativo específico para reconfigurar o cache de provisionamento. É possível usar os seguintes valores:

Powershell
Powershell-LiveId
Powershell-Proxy
PowershellLiveId-Proxy
Ecp
Psws

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-CacheKeys

O parâmetro CacheKeys especifica o valor para a chave de cache que deseja limpar. O formato para os valores deverá conter 32 dígitos separados por quatro travessões: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Use o cmdlet Dump-ProvisioningCache para exibir uma lista de chaves de cache.

Type:	MultiValuedProperty
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

-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 2013, Exchange Server 2016, Exchange Server 2019

-CurrentOrganization

A opção CurrentOrganization redefine o cache de provisionamento para a organização. Não é preciso especificar um valor com essa opção.

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

-GlobalCache

A opção GlobalCache limpa todas as chaves de cache. Não é preciso especificar um valor com essa opção.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Organizations

O parâmetro Organizations especifica as organizações para as quais o cache de provisionamento será reconfigurado. Esse parâmetro é usado para implementações de vários locatários.

Type:	MultiValuedProperty
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

-Server

O parâmetro Server especifica o nome do domínio totalmente qualificado (FQDN) do servidor no qual o aplicativo que deseja reconfigurar está sendo executado.

Type:	Fqdn
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	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.

Type:	SwitchParameter
Aliases:	wi
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

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.