Reset-ProvisioningCache

Referenz

Modul:: ExchangePowerShell

Gilt für::: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Das Cmdlet Reset-ProvisioningCache löscht den Windows PowerShell-Bereitstellungscache häufig verwendeter Active Directory-Objekte. Dieses Cmdlet wird nur zu Diagnosezwecken verwendet.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

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

Beschreibung

Das Cmdlet Reset-ProvisioningCache dient nur zu Diagnosezwecken und wird selten verwendet. Exchange-Administratoren müssen dieses Cmdlet nur ausführen, wenn falsche Links oder Eigenschaften für neu bereitgestellte Empfänger gestempelt werden, was durch veraltete Daten im Bereitstellungscache verursacht werden kann. Dieser Fehler tritt selten auf, da der Bereitstellungscache über eine Invalidierungsbenachrichtigungslogik verfügt.

Das Cmdlet Reset-ProvisioningCache löscht den Windows PowerShell-Bereitstellungscache häufig verwendeter Active Directory-Objekte. Um Active Directory-Anforderungen zu reduzieren, wird ein Bereitstellungscache in jedem Windows PowerShell Runspace initialisiert und verwendet, um allgemeine Objekte zwischenzuspeichern, die häufig von Cmdlets und Bereitstellungshandlern verwendet werden. Während der Ausführung des Exchange-Cmdlets lädt der Bereitstellungscache Konfigurationsobjekte aus Active Directory, um die Ausführung eines Cmdlets zu unterstützen. Wenn Sie beispielsweise ein Postfach erstellen, ruft das Cmdlet New-Mailbox Eigenschaften aus Active Directory ab. Beim Ausführen von Cmdlets werden Konfigurationsobjekte wie Datenbankcontainer, administrative Rollengruppen und LegacyDNs aus Active Directory abgerufen. Da diese Typen von Objekten stabil sind und sich nach ihrer Erstellung monate- oder jahrelang nicht ändern, werden sie im Von Windows PowerShell verwendeten Bereitstellungscache gespeichert. Dadurch wird die Bereitstellungeffizienz gesteigert und die Cmdlet Leistung erheblich verbessert.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

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

In diesem Beispiel wird der Bereitstellungscache für Windows PowerShell zurückgesetzt, die auf dem Server EXSRV1.contoso.com in einer lokalen Exchange-Organisation ausgeführt werden, und gibt an, dass alle Cacheschlüssel gelöscht werden.

Beispiel 2

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

Dieses Beispiel wird in einer mehrinstanzenfähigen Bereitstellung von einem Rechenzentrumsadministrator ausgeführt, um den Bereitstellungscache für Windows PowerShell für den adatum.com Mandanten zurückzusetzen und alle Cacheschlüssel zu löschen.

Parameter

-Application

Der Parameter Application gibt die spezielle Verwaltungsanwendung an, für welche der Bereitstellungscache zurückgesetzt werden soll. Folgende Werte können verwendet werden:

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

Der Parameter CacheKeys gibt den Wert für den Cacheschlüssel an, der gelöscht werden soll. Das Format der Werte sollte 32 Stellen umfassen, die durch vier Bindestriche getrennt sind: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Mit dem Cmdlet Dump-ProvisioningCache können Sie eine Liste von Cacheschlüsseln zurückgeben.

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

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.

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

Der Schalter CurrentOrganization setzt den Bereitstellungscache für die Organisation zurück. Sie müssen bei dieser Option keinen Wert angeben.

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

Der GlobalCache-Schalter löscht alle Cacheschlüssel. Sie müssen bei dieser Option keinen Wert angeben.

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

Der Parameter Organizations gibt die Organisationen an, für die der Bereitstellungscache zurückgesetzt wird. Dieser Parameter wird in mehrinstanzenfähigen Bereitstellungen verwendet.

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

Der Parameter Server gibt den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Servers an, auf dem die zurückzusetzende Anwendung ausgeführt wird.

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

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

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

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

Freigeben über