Partilhar via


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.