Anmeldung und Abmeldung#

Connect-XpServer#

Syntax#

Connect-XpServer [([-UserName] <String> [-Password] <String>) | ([-PSCredential] <PSCredential>)]

Beschreibung#

Der Befehl authentifiziert die aktuelle PowerShell Sitzung am XPhone Connect Server.

Normalerweise müssen vor der Ausführung des ersten Befehls des XPhone Connect Servers in der PowerShell die Anmeldeinformationen in ein Fenster eingegeben werden, welches automatisch nach der Eingabe des ersten Befehls angezeigt wird.

Automatisierte Skripte, die z.B. immer nachts laufen, um neu hinzugekommene Benutzer aus dem Active Directory in Teams einzutragen, können keine Eingabemaske öffnen und eine Benutzerinteraktion fordern.

Mit diesem Befehl besteht die Möglichkeit, die Zugangsdaten entweder im Skript (unsicher) oder in einer verschlüsselten Datei (sicherer, empfohlen) für automatisierte Skripte bereitzustellen.

Parameter#

-UserName <String>
- Der Benutzername eines XPhone Connect Server Systemadministrators, der für den Zugang durch PowerShell-Befehle benutzt werden soll.
-Password <String>
- Das zum Benutzernamen gehörige Passwort eines XPhone Connect Server Systemadministrators, der für den Zugang durch PowerShell-Befehle benutzt werden soll.
-PSCredential <PSCredential>
- Ein durch z.B. Get-Credential generiertes Anmeldedatenobjekt. Für weitere Details siehe Beispiele.

Hinweis

Wird der Befehl ohne Parameter aufgerufen, öffnet sich eine grafische Eingabemaske zur manuellen Authentifizierung der Sitzung.

Eingaben#

Dieser Befehl unterstützt keine Eingabe über die Pipeline und steht daher meist am Anfang einer Befehlskette.

Ausgaben#

Der Befehl Connect-XpServer gibt ein Objekt vom Typ Boolean zurück. Der Wert zeigt an, ob der Login erfolgreich war (True) oder nicht (False). Dieser kann z.B. in einem Skript ausgewertet werden, um abzubrechen, falls kein Login am Server möglich ist.

Beispiel#

Erzeuge eine verschlüsselte „Zugangsdatei“, die dann von mehreren Skripten genutzt werden kann, um sich automatisch am XPhone Connect Server zu authentifizieren:

    >$credential = Get-Credential
    >$credential | Export-CliXml -Path "D:\authenticate.xml"

Erläuterung der Pipeline:

        1. Der erste Schritt öffnet das gewohnte Anmeldefenster.
        2. Die eingegebenen Anmeldedaten werden dann verschlüsselt in die Datei ``D:\authenticate.xml`` gespeichert.

.. attention::

    Die so erzeugte Datei kann nur an demselben Computer mit demselben Windows-Benutzerkonto wieder eingelesen werden, unter dem sie erstellt wurde! Das Skript, welches diese Datei nutzt, muss also unter genau dem Benutzerkonto ausgeführt werden, mit dem die Datei erzeugt wurde.

Lese die vorher erstellte Zugangsdatei ein und führe weitere Befehle aus:

>$credential = Import-CliXml -Path "D:\Zugang.xml";
>Connect-XpServer $credential;
># Restliches Skript
>Disconnect-XpServer;

Disconnect-XpServer#

Syntax#

Disconnect-XpServer

Beschreibung#

Der Befehl entfernt die Zugangsdaten des XPhone Connect Servers aus der aktuellen PowerShell Sitzung.

Um weitere Befehle auf dem XPhone Connect Server ausführen zu können, muss die Sitzung erneut authentifiziert werden. Dies erfolgt beispielsweise per Connect-XpServer oder über die automatisch erscheinende Anmeldemaske bei Eingabe eines beliebigen XPhone Connect Serverkommandos.

Parameter#

Der Befehl wird ohne zusätzliche Parameter verwendet.

Eingaben#

Der Befehl unterstützt keine Eingabe über die Pipeline.

Ausgaben#

Der Befehl gibt keine Objekte zurück.

Beispiel#

Entferne die Anmeldeinformationen aus der aktuellen Sitzung, damit ein Kollege die PowerShell benutzen kann, ohne Daten des XPhone Connect Servers ändern zu können:

>Connect-XpServer „admin" „admin";
>Get-XpUsers „Max Mustermann";
>#... weitere Befehle;
>Disconnect-XpServer

Ab Zeile 4 müssen weitere Befehle an den XPhone Connect Server wieder authentifiziert werden.