Reset-ProvisioningCache
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 -GlobalCacheIn 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 -GlobalCacheDieses 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.