5.2. Modulimport und Verbindung zum Server¶
Zunächst öffnen wir ein PowerShell-Fenster auf unserer Arbeitsstation, auf der wir das IDERI note PowerShell Modul installiert haben. Wir gehen ausserdem davon aus, dass der aktuell angemeldete Benutzer administrative Rechte in IDERI note besitzt. Falls Sie das IDERI note PowerShell Modul noch nicht installiert haben, lesen Sie bitte die Beschreibung dazu in Abschnitt 3.11.
5.2.1. Import des IDERI note PowerShell Moduls¶
Um sicherzugehen, dass das IDERI note PowerShell Modul in der aktuellen Session verfügbar ist, wird folgendes Kommando ausgeführt:
PS> Get-Module -Name Ideri.Note -ListAvailable
Directory: C:\Program Files (x86)\IDERI\IDERI note PowerShell Module
ModuleType Version Name ExportedCommands
---------- ------- ---- ----------------
Binary 1.0.0.0 IDERI.note {Enable-iNoteMessage, Disable-iNoteMe...
Dieses Kommando sollte eine Rückgabe für das zugehörige Modul liefern.
Als nächstes können wir das IDERI note PowerShell Modul mit folgendem Kommando importieren:
PS> Import-Module -Name Ideri.note
5.2.2. Auflistung der CmdLets für das Modul¶
Für eine Liste der verfügbaren CmdLets des Moduls kann folgendes Kommando ausgeführt werden:
PS> Get-Command -Module Ideri.Note
CommandType Name Version Source
----------- ---- ------- ------
Alias Cancel-iNoteMessage 1.0.0.0 Ideri.Note
Alias New-iNoteMessageRevision 1.0.0.0 Ideri.Note
Alias Restart-iNoteMessage 1.0.0.0 Ideri.Note
Alias Stop-iNoteMessage 1.0.0.0 Ideri.Note
Cmdlet Disable-iNoteMessage 1.0.0.0 Ideri.Note
Cmdlet Enable-iNoteMessage 1.0.0.0 Ideri.Note
Cmdlet Get-iNoteAcknowledgement 1.0.0.0 Ideri.Note
Cmdlet Get-iNoteClientConnection 1.0.0.0 Ideri.Note
Cmdlet Get-iNoteLicenseInformation 1.0.0.0 Ideri.Note
Cmdlet Get-iNoteMessage 1.0.0.0 Ideri.Note
Cmdlet Get-iNoteMessageIndex 1.0.0.0 Ideri.Note
Cmdlet Get-iNoteMessageRevision 1.0.0.0 Ideri.Note
Cmdlet Get-iNoteServerVersion 1.0.0.0 Ideri.Note
Cmdlet New-iNoteMessage 1.0.0.0 Ideri.Note
Cmdlet New-iNoteServerConnection 1.0.0.0 Ideri.Note
Cmdlet Remove-iNoteMessage 1.0.0.0 Ideri.Note
Cmdlet Set-iNoteMessage 1.0.0.0 Ideri.Note
Jetzt, da wir wissen, welche CmdLets verfügbar sind, können wir anfangen damit zu arbeiten.
5.2.3. Verbindung zum IDERI note Server¶
Wie in Abschnitt 5.2.2 gezeigt, enthält das IDERI note PowerShell Modul ein CmdLet mit dem Namen New-iNoteServerConnection. Wie die Bezeichnung nahelegt, kann dieses CmdLet verwendet werden, um eine neue Verbindung zu unserem IDERI note Server anzulegen.
PS> New-iNoteServerConnection -ComputerName sv01.note.dev
Das Kommando in diesem Beispiel zeigt, wie eine neue Verbindung zu unserem Server mit dem Namen ‘sv01.note.dev’ angelegt werden kann. Es müssen dabei keine weiteren Parameter angegeben werden, da unsere Arbeitsstation Teil derselben Domäne wie der IDERI note Server ist und der ausführende Benutzer bereits administrative Rechte in IDERI note hat.
Soll die Verbindung zum Server mit einem anderen Benutzerkonto angelegt werden, können wir alternative Zugangsdaten beispielsweise mit folgendem Aufruf angeben:
PS> New-iNoteServerConnection -ComputerName NOTE-SRV01.note.dev `
-Credential (Get-Credential)
Damit wird eine Aufforderung zur Eingabe der Benutzerkennung mit Angabe des Passworts angezeigt, bevor eine Verbindung zum IDERI note Server angelegt werden kann.
Ist die Verbindungsaufnahme erfolgreich, wird die Information darüber in einer Variablen mit dem Namen $IDERInoteServerSession gespeichert.
PS> $IDERInoteServerSession
Servername : sv01.note.dev
Username :
Domain :
Password :
UseNamedPipes : True
TCPPort : 0