Standorte

Get-XpLocation

Syntax

Get-XpLocations [[-LocationNames] <String[]>] [-Timeout <int>] [<CommonParameters>]

Beschreibung

Der Befehl Get-XpLocations gibt Standort-Objekte zurück.

Ohne Parameter gibt Get-XpLocations alle Standorte des XPhone Connect Servers aus. Es können zusätzlich jedoch ein oder mehrere Standortnamen angegeben werden, nach denen dann auf dem XPhone Connect Server gesucht wird.

Standardmäßig gibt der Befehl nur den Namen des Standorts sowie seine Beschreibung aus. Mithilfe des Befehls Select-Object können jedoch alle verfügbaren Eigenschaften der Standorte ausgegeben werden (siehe Beispiele).

Parameter

-LocationNames <String[]>
- Dieser optionale Parameter spezifiziert einen oder mehrere Standortnamen. Auf dem XPhone Connect Server werden dann anhand dieser Namen Standorte gesucht.
- Mehrere Namen werden durch Komma getrennt angegeben.
  
  Hinweis
  
  Groß- und Kleinschreibung muss beachtet werden!
- Das Wildcard-Symbol * kann sowohl am Anfang als auch am Ende der zu suchenden Zeichenkette verwendet werden. So gibt -LocationNames Haupt* z.B.
  die Standorte mit den Namen „Hauptstandort“
  
  und „Hauptnebenstelle“ aus.
- Sollten Namen Sonderzeichen wie z.B. Leerzeichen oder Kommata enthalten, müssen die Namen in Anführungsstriche gesetzt werden:
  -XpLocations -LocationNames "Frankfurt am Main","Haupt-Standort"
-Timeout <int>
- Zeitüberschreitung in Minuten.
- Wenn ein Kommando (z.B. aufgrund zu vieler Datensätze o.ä.) zu lange benötigt, kann dieses Kommando mit diesem Parameter nach der angegebenen Zeit abgebrochen werden.
<CommonParameters>
- Beschreibt die Parameter, die mit jedem Cmdlet verwendet werden können. Siehe Microsoft Dokumentation.

Eingaben

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

Ausgaben

Der Befehl Get-XpLocations gibt Objekte vom Typ CFGBranch zurück.

CFGBranch:

Property	Supported values
Description	String
FunctionAnnouncement	BranchActive BranchInactive
FunctionClient	BranchActive BranchInactive
FunctionCollaboration	BranchActive BranchInactive
FunctionContactList	BranchActive BranchInactive
FunctionFax	BranchActive BranchInactive
FunctionAnnouncement	BranchActive BranchInactive
FunctionLanguage	BranchActive BranchInactive
FunctionMailbox	BranchActive BranchInactive
FunctionMobileControl	BranchActive BranchInactive
FunctionPasswordComplexity	BranchActive BranchInactive
FunctionPresence	BranchActive BranchInactive
FunctionSms	BranchActive BranchInactive
FunctionTelephony	BranchActive BranchInactive
FunctionVoicemail	BranchActive BranchInactive
Id	-
Name	String
ExtensionData	-
UtcOffset	-

Beispiel

Zeige alle Standorte:
```
>Get-XpLocations
```
Zeige alle Standorte, die mit „Ha“ beginnen:
```
>Get-XpLocations Ha*
```
Zeige die Standorte Hauptstandort und Nebenstelle:
```
>Get-XpLocations Hauptstandort,Nebenstelle
```
Zeige den Standort Hauptstandort 2 (enthält Leerzeichen!):
```
>Get-XpLocations "Hauptstandort 2"
```

Set-XpLocations

Syntax

Set-XpLocations [-Objects] <CFGBranch[]> [<CommonParameters>]

Beschreibung

Das Cmdlet Set-XpLocations speichert die übergebenen CFGBranch Objekte aus Get-XpLocations im XPhone Connect Server.

Alle Änderungen am Objekt werden sofort und ohne Rückfrage an den XPhone Connect Server übertragen und dort gespeichert.

Warnung

Die Änderungen sind anschließend nicht mehr rückgängig zu machen. Eine gründliche Überprüfung der geänderten Daten ist daher unumgänglich.

Parameter

-Objects <CFGBranch[]>
- Die Liste von CFGBranch Objekten stammt von Get-XpLocations, wird dann verändert und anschließend über die Pipeline an Set-XpLocations weitergeleitet (siehe Eingaben).
- Dieser Parameter ist zwingend erforderlich; andernfalls können keine Standorte auf dem XPhone Connect Server gespeichert werden.
-Timeout <int>
- Zeitüberschreitung in Minuten.
- Wenn ein Kommando (z.B. aufgrund zu vieler Datensätze o.ä.) zu lange benötigt, kann dieses Kommando mit diesem Parameter nach der angegebenen Zeit abgebrochen werden.
<CommonParameters>
- Beschreibt die Parameter, die mit jedem Cmdlet verwendet werden können. Siehe Microsoft Dokumentation.

Eingaben

Der Eingabetyp ist der Typ der Objekte, die per Pipelining an Set-XpLocations übergeben werden können:

CFGBranch

Ausgaben

Der Befehl Set-XpLocations gibt keine Objekte zurück.

Beispiel

Das generelle Vorgehen beim Ändern von Standortdaten ist folgendes:

Gewünschte Standorte holen >Get-XpLocations
Eigenschaften verändern >foreach{$_.Eigenschaft = „Wert“;$_}
Änderung der Standorte speichern im XPhone Connect Server >Set-XpLocations

Es ist wichtig, nach Schritt 2 (Änderung) die Daten noch einmal zu überprüfen, bevor sie im XPhone Connect Server gespeichert werden. Dazu wird der 3. Schritt (Speichern) zunächst weggelassen. Alle Objekte werden dann in ihrem geänderten Zustand auf der PowerShell Konsole ausgegeben, jedoch noch nicht gespeichert.

Beispiel Set-XpLocations

Deaktivierung von Fax in allen Standorten:

>Get-XpLocations | foreach{$_.FunctionFax = "BranchInactive";$_} | Set-XpLocations

Hinweis

Um in diesem Beispiel die Änderungen vor dem Speichern zu überprüfen, wird Schritt 3 (Set-XpLocations) weggelassen. Es entsteht der folgende Befehl:
>Get-XpLocations | foreach{$_.FunctionFax = "BranchInactive";$_}

Analog zu 1: Aktivierung von Fax in allen Standorten:

>Get-XpLocations | foreach{$_.FunctionFax = "BranchActive";$_} | Set-XpLocations

Deaktivierung von Fax und Voicemail in den Standorten Hauptstandort und Nebenstelle:

>Get-XpLocations „Hauptstandort“,“Nebenstelle“ | foreach{$_.FunctionFax = "BranchInactive"; $_.FunctionVoiceMail = "BranchInactive";$_} | Set-XpLocations

Haben Sie einen Fehler auf dieser Seite gefunden?

Oder ist etwas nicht gut oder zu ungenau formuliert? Dann freuen wir uns über eine E-Mail, am besten mit einem Verbesserungsvorschlag, an doku@c4b.de. Vielen Dank!