Reset-ProvisioningCache

Riferimento

Modulo:: ExchangePowerShell

Si applica a:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Questo cmdlet è disponibile solo in Exchange locale.

Il cmdlet Reset-ProvisioningCache cancella la cache di provisioning Windows PowerShell degli oggetti Active Directory usati di frequente. Questo cmdlet è utilizzato principalmente a fini diagnostici.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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>]

Descrizione

Il cmdlet Reset-ProvisioningCache è utilizzato raramente e solo per fini diagnostici. Gli amministratori di Exchange devono eseguire questo cmdlet solo se vengono contrassegnati collegamenti o proprietà non corretti sui destinatari di cui è stato effettuato il provisioning, che possono essere causati da dati non aggiornati nella cache di provisioning. Questo è un caso raro, poiché la cache di provisioning dispone della logica di notifica dell'invalidamento dati.

Il cmdlet Reset-ProvisioningCache cancella la cache di provisioning Windows PowerShell degli oggetti Active Directory usati di frequente. Per ridurre le richieste di Active Directory, viene inizializzata una cache di provisioning in ogni Windows PowerShell spazio di esecuzione e viene usata per memorizzare nella cache gli oggetti comuni usati di frequente dai cmdlet e dai gestori di provisioning. Durante l'esecuzione del cmdlet di Exchange, la cache di provisioning carica gli oggetti di configurazione da Active Directory per consentire l'esecuzione di un cmdlet. Ad esempio, quando si crea una cassetta postale, il cmdlet New-Mailbox ottiene le proprietà da Active Directory. Quando si eseguono cmdlet, oggetti di configurazione come contenitori di database, gruppi di ruoli amministrativi e legacyDN vengono recuperati da Active Directory. Poiché questi tipi di oggetti sono stabili e non cambiano per mesi o anni dopo la creazione, vengono archiviati nella cache di provisioning usata da Windows PowerShell. Questo aumenta l'efficienza del provisioning e migliora significativamente le prestazioni del cmdlet.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

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

In questo esempio viene reimpostata la cache di provisioning per Windows PowerShell in esecuzione nel server EXSRV1.contoso.com in un'organizzazione di Exchange locale e viene specificato che tutte le chiavi della cache vengono cancellate.

Esempio 2

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

Questo esempio viene eseguito in una distribuzione multi-tenant da un amministratore del data center per reimpostare la cache di provisioning per Windows PowerShell per il tenant adatum.com e cancellare tutte le chiavi della cache.

Parametri

-Application

Il parametro Application consente di specificare l'applicazione amministrativa per cui azzerare la cache di provisioning. È possibile utilizzare i seguenti valori:

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

Il parametro CacheKeys consente di specificare il valore per la chiave della cache da cancellare. Il formato per i valori deve contenere 32 cifre separate da quattro trattini: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Utilizzare il cmdlet Dump-ProvisioningCache per restituire un elenco di chiavi della 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

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.

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

L'opzione CurrentOrganization reimposta la cache di provisioning per l'organizzazione. Con questa opzione non è necessario specificare alcun valore.

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

L'opzione GlobalCache cancella tutte le chiavi della cache. Con questa opzione non è necessario specificare alcun valore.

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

Il parametro Organizations consente di specificare le organizzazioni per cui azzerare la cache di provisioning. Questo parametro è utilizzato nelle distribuzioni multi-tenant.

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

Il parametro Server consente di specificare il nome di dominio completo del server su cui è in esecuzione l'applicazione da reimpostare.

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

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

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

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.