Reset-ProvisioningCache
Este cmdlet está disponível somente no Exchange local.
O cmdlet Reset-ProvisioningCache limpa a cache de aprovisionamento Windows PowerShell de objetos do Active Directory utilizados frequentemente. 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.
Sintaxe
GlobalCache
Reset-ProvisioningCache
[-Server] <Fqdn>
-Application <String>
[-GlobalCache]
[-CacheKeys <MultiValuedProperty>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
OrganizationCache
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 só precisam de executar este cmdlet se forem carimbadas ligações ou propriedades incorretas nos destinatários recém-aprovisionados, o que pode ser causado por dados obsoletos na cache de aprovisionamento. 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 a cache de aprovisionamento Windows PowerShell de objetos do Active Directory utilizados frequentemente. Para reduzir os pedidos do Active Directory, uma cache de aprovisionamento é inicializada em cada Windows PowerShell espaço de execução e é utilizada para colocar em cache objetos comuns que são frequentemente utilizados por cmdlets e processadores de aprovisionamento. Durante a execução do cmdlet do Exchange, a cache de aprovisionamento carrega objetos de configuração do Active Directory para ajudar a executar um cmdlet. Por exemplo, quando cria uma caixa de correio, o cmdlet New-Mailbox obtém propriedades do Active Directory. Ao executar cmdlets, os objetos de configuração, como contentores de bases de dados, grupos de funções administrativas e LegacyDNs, são obtidos a partir do Active Directory. Uma vez que estes tipos de objetos são estáveis e não mudam durante meses ou anos após a criação, são armazenados na cache de aprovisionamento utilizada pelo 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 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
Reset-ProvisioningCache -Server EXSRV1.contoso.com -Application Powershell -GlobalCache
Este exemplo repõe a cache de aprovisionamento para Windows PowerShell em execução no servidor EXSRV1.contoso.com numa organização do Exchange no local e especifica que todas as chaves de cache estão limpas.
Exemplo 2
Reset-ProvisioningCache -Application Powershell-Proxy -Server datacenter1.adatum.com -GlobalCache
Este exemplo é executado numa implementação multi-inquilino por um administrador do datacenter para repor a cache de aprovisionamento para Windows PowerShell para o inquilino adatum.com e limpar todas as chaves de cache.
Parâmetros
-Application
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CacheKeys
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 |
-Confirm
Aplicável: 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 |
-CurrentOrganization
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador CurrentOrganization repõe a cache de aprovisionamento para a organização. 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 |
Conjuntos de parâmetros
OrganizationCache
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-GlobalCache
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador GlobalCache limpa todas as chaves de cache. 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 |
Conjuntos de parâmetros
GlobalCache
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Organizations
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro Organizações especifica as organizações onde a cache de aprovisionamento é reposta. Utilize este parâmetro em implementações multi-inquilino.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
OrganizationCache
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Server
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: 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.