Verwalten von Cmdlet-Erweiterungs-Agents

  • Artikel

Gilt für: Exchange Server 2013

In diesem Thema wird das Aktivieren, Deaktivieren, Anzeigen und Ändern der Priorität von Cmdlet-Erweiterungs-Agents in Exchange Server 2013 erläutert. Weitere Informationen zu Cmdlet-Erweiterungs-Agents in Exchange 2013 finden Sie unter Cmdlet-Erweiterungs-Agents.

Was sollten Sie wissen, bevor Sie beginnen?

  • Geschätzte Zeit bis zum Abschließen der einzelnen Verfahren: Weniger als 5 Minuten

  • Bevor Sie diese Verfahren ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Informationen zu den von Ihnen benötigten Berechtigungen finden Sie unter "Cmdlet-Erweiterungs-Agents" im Thema Exchange- und Shellinfrastrukturberechtigungen.

  • Bevor Sie aktivieren Scripting Agent, müssen Sie überprüfen, ob sie ordnungsgemäß konfiguriert ist. Weitere Informationen zu finden Scripting AgentSie unter Cmdlet-Erweiterungs-Agents.

  • Sie müssen diese Verfahren mithilfe der Shell ausführen.

  • Informationen zu Tastenkombinationen für die Verfahren in diesem Thema finden Sie unter Tastenkombinationen in der Exchange-Verwaltungskonsole.

Tipp

Liegt ein Problem vor? Bitten Sie in den Exchange-Foren um Hilfe. Besuchen Sie die Foren auf Exchange Server.

Aktivieren eines Cmdlet-Erweiterungs-Agents

Wenn Sie in Exchange 2013 einen Cmdlet-Erweiterungs-Agent aktivieren, wird dieser auf allen Servern mit Exchange 2013 in der Organisation ausgeführt. Wenn ein Agent aktiviert ist, wird er für Cmdlets verfügbar gemacht, die dann mithilfe des Agents weitere Vorgänge ausführen können.

Warnung

Machen Sie sich vor dem Aktivieren von Agents mit der Funktionsweise des jeweiligen Agents und den Auswirkungen der Aktivierung in der Organisation vertraut.

In diesem Beispiel wird ein Cmdlet-Erweiterungs-Agent mithilfe des Cmdlets Enable-CmdletExtensionAgent aktiviert. Bei der Ausführung dieses Cmdlets müssen Sie den Namen des Agents angeben, der aktiviert werden soll. Bevor Sie aktivieren Scripting Agent, müssen Sie sicherstellen, dass Sie die ScriptingAgentConfig.xml Konfigurationsdatei auf allen Servern in Ihrer Organisation bereitgestellt haben. Wenn Sie die Konfigurationsdatei nicht zuerst bereitstellen und aktivieren Scripting ``Agent, schlagen alle Nicht-Get-Cmdlets fehl, wenn sie ausgeführt werden. In diesem Beispiel wird aktiviert Scripting Agent.

Enable-CmdletExtensionAgent "Scripting Agent"

Ausführliche Informationen zu Syntax und Parametern finden Sie unter Enable-CmdletExtensionAgent.

Deaktivieren eines Cmdlet-Erweiterungs-Agents

Wenn Sie in Exchange 2013 einen Cmdlet-Erweiterungs-Agent deaktivieren, wird dieser auf allen Servern mit Exchange 2013 in der Organisation deaktiviert. Ist ein Agent deaktiviert, wird er Cmdlets nicht zur Verfügung gestellt. Cmdlets können den Agent nicht mehr für zusätzliche Operationen verwenden.

Warnung

Machen Sie sich vor dem Deaktivieren von Agents mit der Funktionsweise des jeweiligen Agents und den Auswirkungen der Deaktivierung in der Organisation vertraut.

Um einen Cmdlet-Erweiterungs-Agent zu deaktivieren, verwenden Sie das Cmdlet Disable-CmdletExtensionAgent. Geben Sie beim Ausführen des Cmdlets den Namen des Agents an, den Sie deaktivieren möchten. In diesem Beispiel wird deaktiviert Scripting Agent.

Disable-CmdletExtensionAgent "Scripting Agent"

Ausführliche Informationen zu Syntax und Parametern finden Sie unter Disable-CmdletExtensionAgent.

Anzeigen vorhandener Cmdlet-Erweiterungs-Agents

Durch Anzeigen vorhandener Cmdlet-Erweiterungs-Agents können Sie prüfen, welche Agents zuerst ausgeführt werden und in einer Exchange 2013-Organisation aktiviert sind. Weitere Informationen zum Pipelining und zum Cmdlet Format-Table finden Sie unter den folgenden Themen:

In diesem Beispiel werden mithilfe des Cmdlets Get-CmdletExtensionAgent Details eines bestimmten Cmdlet-Erweiterungs-Agents abgerufen. In diesem Beispiel werden die Details der Mailbox Permissions Agent zurückgegeben.

Get-CmdletExtensionAgent "Mailbox Permissions Agent"

In diesem Beispiel werden mehrere Cmdlet-Erweiterungs-Agents mithilfe des Cmdlets Get-CmdletExtensionAgent abgerufen und die Ausgabe dann an das Cmdlet Format-Table weitergeleitet. In diesem Beispiel wird eine Liste aller Cmdlet-Erweiterungs-Agents in der Organisation angezeigt, und mithilfe des Cmdlets Format-Table werden die Eigenschaften Name, Enabled und Priority jedes Agents in einer Tabelle angezeigt.

Get-CmdletExtensionAgent | Format-Table Name, Enabled, Priority

Ausführliche Informationen zu Syntax und Parametern finden Sie unter Get-CmdletExtensionAgent.

Ändern der Priorität eines Cmdlet-Erweiterungs-Agents

Die Möglichkeit, die Priorität eines Cmdlet-Erweiterungs-Agents in Exchange 2013 zu ändern, ist nützlich, wenn ein Cmdlet einen bestimmten Agent vor einem anderen Agent aufrufen soll. Dies ist besonders nützlich, wenn Sie ein benutzerdefiniertes Skript erstellen, das Scripting Agentin ausgeführt wird, und sie möchten, dass dieses Skript Vorrang vor einem integrierten Agent hat. Weitere Informationen zu finden Scripting AgentSie unter Cmdlet-Erweiterungs-Agents.

Warnung

Das Ändern der Priorität oder das Ersetzen der Funktionalität eines integrierten Agents stellt einen erweiterten Vorgang dar. Stellen Sie sicher, dass Sie die Auswirkungen der Änderungen vollständig verstehen, die Sie vornehmen.

Agents werden von 0 bis zur maximalen Anzahl von Agents geordnet. Je näher bei Null die Position eines Agents ist, umso höher ist die Priorität dieses Agents. Agents mit einer höheren Priorität werden zuerst aufgerufen. Weitere Informationen zur Priorität von Agents finden Sie unter Cmdlet-Erweiterungs-Agents.

Im folgenden Beispiel wird die Priorität eines Cmdlet-Erweiterungs-Agents mithilfe des Cmdlets Set-CmdletExtensionAgent geändert. In diesem Beispiel wird die Priorität von Scripting Agent in 3 geändert.

Set-CmdletExtensionAgent "Scripting Agent" -Priority 3

Ausführliche Informationen zu Syntax und Parametern finden Sie unter Set-CmdletExtensionAgent.