PowerShell API-Wrapper Tutorial: Unterschied zwischen den Versionen
| [unmarkierte Version] | [unmarkierte Version] |
Admin (Diskussion | Beiträge) |
Admin (Diskussion | Beiträge) |
||
| Zeile 1: | Zeile 1: | ||
++ Under construction ++ | ++ Under construction ++ | ||
| − | Dieses Tutorial erläutert anhand einfacher Beispiele den Umgang mit der [[MailStore Server Administration API]] mittels Windows PowerShell Skripten. Grundlegende Windows und PowerShell Kenntnisse werden dabei vorausgesetzt. | + | Dieses Tutorial erläutert anhand einfacher Beispiele den Umgang mit der [[MailStore Server Administration API]] mittels Windows PowerShell Skripten. Grundlegende MailStore Server, Windows und PowerShell Kenntnisse werden dabei vorausgesetzt. |
<p class=msnote>'''Hinweis:''' Es wird empfohlen, für dieses Tutorial und grundsätzlich für die Skriptentwicklung eine eigene, nicht produktive Instanz von MailStore Server in einer Testumgebung zu verwenden, um Probleme und Datenverluste in der Produktivumgebung zu vermeiden. Hierfür eignet sich z.B. die voll funktionsfähige, 30-Tage-Testversion von MailStore Server.</p> | <p class=msnote>'''Hinweis:''' Es wird empfohlen, für dieses Tutorial und grundsätzlich für die Skriptentwicklung eine eigene, nicht produktive Instanz von MailStore Server in einer Testumgebung zu verwenden, um Probleme und Datenverluste in der Produktivumgebung zu vermeiden. Hierfür eignet sich z.B. die voll funktionsfähige, 30-Tage-Testversion von MailStore Server.</p> | ||
| Zeile 10: | Zeile 10: | ||
[[Media:MailStorePSAPIWrapper.zip?|MailStore PowerShell API Wrapper]]<br/> | [[Media:MailStorePSAPIWrapper.zip?|MailStore PowerShell API Wrapper]]<br/> | ||
| − | [[Media: | + | [[Media:MailStorePSTutorialScripts.zip?|MailStore PowerShell Tutorial Beispielskripte]]<br/> |
[https://my.mailstore.com/TrialLicense/RequestForm?lang=de 30-Tage-Testversion von MailStore Server]<br/> | [https://my.mailstore.com/TrialLicense/RequestForm?lang=de 30-Tage-Testversion von MailStore Server]<br/> | ||
[http://www.microsoft.com/en-us/download/details.aspx?id=34595 Windows Management Framework 3.0] (enthält die PowerShell 3.0)<br/> | [http://www.microsoft.com/en-us/download/details.aspx?id=34595 Windows Management Framework 3.0] (enthält die PowerShell 3.0)<br/> | ||
| Zeile 18: | Zeile 18: | ||
<p class=msnote><span style="color:red">'''Wichtiger Hinweis:'''</span> Die Installation eines Windows Management Frameworks wird auf Systemen, welche eine bestimmte PowerShell Version voraussetzen und erweitern, wie beispielsweise Microsoft Exchange Server, nicht unterstützt und kann die Funktion dieser Systeme massiv beeinträchtigen oder zum Erliegen bringen.</p> | <p class=msnote><span style="color:red">'''Wichtiger Hinweis:'''</span> Die Installation eines Windows Management Frameworks wird auf Systemen, welche eine bestimmte PowerShell Version voraussetzen und erweitern, wie beispielsweise Microsoft Exchange Server, nicht unterstützt und kann die Funktion dieser Systeme massiv beeinträchtigen oder zum Erliegen bringen.</p> | ||
| + | |||
| + | Nach dem Herunterladen und ggf. der Installation der PowerShell entpacken Sie bitte den MailStore PowerShell API Wrapper und die Beispielskripte (standardmäßig nach ''C:\MailStore Scripting Tutorial\PowerShell\''). | ||
| + | |||
| + | = Grundlegende Funktionalität des MailStore PowerShell API Wrappers = | ||
| + | |||
| + | Der MailStore PowerShell API Wrapper ist als PowerShell Script Module (''MSS.PS.Lib.psm1'') implementiert und wird daher über sein Manifest (''MSS.PS.Lib.psd1'') per ''Import-Module'' in eine PowerShell Session eingebunden. Via ''Get-Module'' können die zu Verfügung gestellten Funktionen, Aliase und Variablen angezeigt werden. Für die Funktionen kann mittels ''Get-Help'' die Inline Hilfe der jeweiligen Funktion aufgerufen werden. | ||
| + | |||
| + | <p class=msnote>'''Hinweis:''' Der MailStore PowerShell API Wrapper und die Beispielskripte sind nicht digital signiert. Daher muss zunächst die Ausführung solcher Skripte in einer administrativen PowerShell Session mittels<br/><code> Set-ExecutionPolicy -ExecutionPolicy Unrestricted</code><br/>zugelassen werden.</p> | ||
| + | |||
| + | == Informationen zum MailStore PowerShell API Wrapper abrufen == | ||
| + | |||
| + | # Öffnen Sie eine PowerShell Session und binden Sie das API Wrapper Modul mit folgenden Befehl ein: | ||
| + | #: <code>Import-Module "C:\MailStore Scripting Tutorial\PowerShell\API-Wrapper\MSS.PS.Lib.psm1"</code> | ||
| + | # Geben Sie folgenden Befehl ein, um Informationen über das Modul abzurufen: | ||
| + | #: <code>Get-Module MSS.PS.Lib|fl</code> | ||
| + | [[Datei:PS API Wrapper Tutorial 1.PNG|540px|center]] | ||
Version vom 9. Januar 2014, 14:44 Uhr
++ Under construction ++
Dieses Tutorial erläutert anhand einfacher Beispiele den Umgang mit der MailStore Server Administration API mittels Windows PowerShell Skripten. Grundlegende MailStore Server, Windows und PowerShell Kenntnisse werden dabei vorausgesetzt.
Hinweis: Es wird empfohlen, für dieses Tutorial und grundsätzlich für die Skriptentwicklung eine eigene, nicht produktive Instanz von MailStore Server in einer Testumgebung zu verwenden, um Probleme und Datenverluste in der Produktivumgebung zu vermeiden. Hierfür eignet sich z.B. die voll funktionsfähige, 30-Tage-Testversion von MailStore Server.
Installation der benötigten Komponenten
Die gezeigten Beispiele nutzen den MailStore PowerShell API Wrapper und sind wie dieser auf Windows PowerShell ab Version 3.0 lauffähig. Abhängig von der verwendeten Windows Version muss eine kompatible PowerShell Version zunächst heruntergeladen und installiert werden. Die für das Tutorial benötigten Komponenten finden Sie hier:
MailStore PowerShell API Wrapper
MailStore PowerShell Tutorial Beispielskripte
30-Tage-Testversion von MailStore Server
Windows Management Framework 3.0 (enthält die PowerShell 3.0)
Windows Management Framework 4.0 (alternativ, enthält die PowerShell 4.0)
Bitte beachten Sie auch die Systemvoraussetzungen und Hinweise zur jeweiligen Version des Windows Management Frameworks.
Wichtiger Hinweis: Die Installation eines Windows Management Frameworks wird auf Systemen, welche eine bestimmte PowerShell Version voraussetzen und erweitern, wie beispielsweise Microsoft Exchange Server, nicht unterstützt und kann die Funktion dieser Systeme massiv beeinträchtigen oder zum Erliegen bringen.
Nach dem Herunterladen und ggf. der Installation der PowerShell entpacken Sie bitte den MailStore PowerShell API Wrapper und die Beispielskripte (standardmäßig nach C:\MailStore Scripting Tutorial\PowerShell\).
Grundlegende Funktionalität des MailStore PowerShell API Wrappers
Der MailStore PowerShell API Wrapper ist als PowerShell Script Module (MSS.PS.Lib.psm1) implementiert und wird daher über sein Manifest (MSS.PS.Lib.psd1) per Import-Module in eine PowerShell Session eingebunden. Via Get-Module können die zu Verfügung gestellten Funktionen, Aliase und Variablen angezeigt werden. Für die Funktionen kann mittels Get-Help die Inline Hilfe der jeweiligen Funktion aufgerufen werden.
Hinweis: Der MailStore PowerShell API Wrapper und die Beispielskripte sind nicht digital signiert. Daher muss zunächst die Ausführung solcher Skripte in einer administrativen PowerShell Session mittels Set-ExecutionPolicy -ExecutionPolicy Unrestricted
zugelassen werden.
Informationen zum MailStore PowerShell API Wrapper abrufen
- Öffnen Sie eine PowerShell Session und binden Sie das API Wrapper Modul mit folgenden Befehl ein:
Import-Module "C:\MailStore Scripting Tutorial\PowerShell\API-Wrapper\MSS.PS.Lib.psm1"
- Geben Sie folgenden Befehl ein, um Informationen über das Modul abzurufen:
Get-Module MSS.PS.Lib|fl
