Lizenzen#

Get-XpLicensesUser#

Syntax#

Parameter-Set locations:

Get-XpLicensesUser -Locations <CFGBranch[]> [-Timeout <int>]

Parameter-Set configGroups:

Get-XpLicensesUser -ConfigGroups <CFGConfigGroup[]> [-Timeout <int>]

Parameter-Set user:

Get-XpLicensesUser -UserNames <String[]> [-Timeout <int>]

Beschreibung#

Get-XpLicensesUser verhält sich wie die Suchfunktion der Web-Administration des XPhone Connect Servers (Systemeinstellungen > Lizenzen > Benutzer).

Alle Parametersets nutzen dieselbe Schnittstelle der Suchfunktion. Bei Namenskonflikten zwischen Standorten und Benutzernamen (wenn eines eine Teilzeichenkette des anderen ist) können möglicherweise nicht die gewünschten Ergebnisse angezeigt werden.

Parameter#

-Locations <CFGBranch[]>
- Wenn dieser Parameter angegeben wird, erfolgt die Suche nach den Namen der Standorte.
- „Entspricht dem Parameter -UserNames <Standortname[]>
-ConfigGroups <CFGConfiggroups[]>
- Wenn dieser Parameter angegeben wird, erfolgt die Suche nach den Namen der Konfigurationsgruppen.
- „Entspricht dem Parameter -UserNames <KonfigurationsgruppenName[]>
-UserNames
- Entspricht der normalen Lizenz-Benutzer-Suche in der Web-Administration des XPhone Connect Servers. Hier kann also auch nach Standortnamen, Anmeldenamen etc. gesucht werden.
- Mehrere Suchbegriffe werden durch Komma getrennt angegeben.
-Timeout <int>
- Timeout 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.

Eingaben#

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

CFGBranch
CFGConfigGroup

Ausgaben#

Der Befehl Get-XpLicensesUser gibt Objekte vom Typ XPCLicenseUser zurück:

XPCLicenseUser

Property	Supported values
XmppAddress	-
LicenseOwner	-
LicenseDepartment	-
LicenseAnalytics	-
LicenseApplink	-
LicenseFax	-
LicenseOffice	-
LicenseOfficePlusPack	-
LicenseTapi	-
LicenseVoiceMail	-

Beispiel#

Export aller Lizenzen in eine Excel-kompatible Datei, damit diese ausgewertet oder gedruckt werden kann:
```
>Get-XpLicensesUser * | Export-Csv "C:\path\XPhoneLicenses.csv" -Delimiter ";"
```

Der Pfad(C:\path\XPhoneLicenses.csv) zur angegebenen Datei muss bereits existieren, die Datei selbst jedoch noch nicht. Der Parameter -Delimiter ; ist für viele Sprachen notwendig (z.B. Deutsch), damit Excel die Datei als CSV-Datei erkennt.

Anzeigen aller Benutzer, die eine Faxlizenz gezogen haben:
```
>Get-XpLicensesUser * | Where{$_.LicenseFax -eq "1"}
```