Benutzer#
Get-XpUsers#
Syntax#
Get-XpUsers [[-UserNames] <String[]>] [-Timeout <int>]
Beschreibung#
Der Befehl führt eine Suche nach Benutzern auf dem XPhone Connect Server aus und gibt das Ergebnis als Liste von CFGUser Objekten aus. Standardmäßig werden nur der Kontoname und die Telefonnummer angezeigt.
Dies entspricht der erweiterten Suche in der XPhone Connect Server Web-Administration (Suche nach Benutzern, E-Mail-Adressen, Rufnummern, Faxnummer).
Parameter#
-UserNames <String[]>Gibt den String an, nach dem auf dem XPhone Connect Server gesucht wird.
Es können mehrere Namen, E-Mail-Adressen, Rufnummern oder Faxnummern angegeben werden, die durch Komma getrennt werden.
Es wird dringend empfohlen, umschließende Anführungszeichen zu verwenden, da in den Strings häufig Sonderzeichen (z.B. Leerzeichen) vorkommen.
-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.
Eingaben#
Dieser Befehl unterstützt keine Eingabe über die Pipeline und steht daher meist am Anfang einer Befehlskette.
Ausgaben#
Der Befehl Get-XpUsers gibt Objekte vom Typ CFGUser zurück.
CFGUser |
|
Property |
Supported values |
AccountName |
String |
AllowOtherLogin |
Boolean |
AllowWindowsLogin |
Boolean |
AllowXServerLogin |
Boolean |
AuthUserLocked |
Boolean |
AuthUserUnlockDateTime |
|
CfgMailBoxAccessType |
INTEGRIERT |
CfgUserDirectAccessCallNumber |
|
CfgUserDirectAccessGroupId |
Integer |
CfgUserFaxGroupId |
Integer |
CfgUserFaxNumber |
String |
CfgUserMailBoxUserGroupId |
Integer |
CfgUserMailBoxUserName |
String |
CfgUserSmsReceiverCallNumber |
String |
CfgUserSmsReceiverCallNumberGroupId |
Integer |
CfgUserSmsSenderCallNumber |
String |
CfgUserSmsSenderCallNumberGroupId |
Integer |
CfgUserVoiceMailCallGroupId |
Integer |
CfgUserVoiceMailCallNumber |
String |
City |
String |
Company |
String |
Country |
String |
Department |
String |
DesktopClientDisplayVersion |
|
String |
|
FaxNumber |
String |
FirstName |
String |
LastName |
String |
MobileClientDisplayVersion |
|
HomeOfficeNumber |
String |
HomePhoneNumber |
String |
Interlock |
|
InterlockDescr |
|
Language |
|
Languages |
|
LastLoginDate |
|
LoginSystemTypeList |
|
MobileTelephoneNumber |
String |
ModifyTimeStamp |
|
OldPrimaryLineSource |
|
Password |
|
PasswordChanged |
|
PasswordConfirm |
|
Photo |
|
Position |
String |
PostalCode |
String |
PrimaryLineSource |
Integer |
PrimaryLineSourceList |
|
RelationshipRole |
Normal |
RelationshipRoleAssistant |
Boolean |
RelationshipRoleVip |
Boolean |
RequiredPasswordComplexity |
|
RoomNumber |
String |
Salutation |
String |
Street |
String |
SystemID |
|
SystemType |
|
TelephoneNumber |
String |
TelephonyNotAvailable |
|
Title |
String |
UMSUserConfigFaxAvailable |
Boolean |
UMSUserConfigNotAvailable |
Boolean |
UMSUserConfigSmsAvailable |
Boolean |
UMSUserConfigVoiceMailAvailable |
Boolean |
UserDefined1 |
String |
UserDefined2 |
String |
UserDefined3 |
String |
UserDefined4 |
String |
VirtualLines |
|
VoicemailPin |
|
VoicemailPinChanged |
Boolean |
VoicemailPinMinLength |
String |
WindowsAccountName |
String |
XmppAddress |
String |
XmppAddressDomain |
String |
XmppAddressLocal |
String |
Description |
String |
Name |
|
ObjectGuid |
|
ParentGuid |
|
DCObjectInfo |
|
ExtensionData |
|
UtcOffset |
Beispiel#
Zeige alle Benutzer an:
>Get-XpUsers
Zeige den Benutzer
Anna Ambergan:>Get-XpUsers "Anna Amberg"
Zeige alle Benutzer aus der Abteilung
Vertrieb:>Get-XpUsers | Where{$_.Department -eq "Vertrieb"}Zeige alle Benutzer, die die Mobile App noch nie verwendet haben:
>Get-XpUsers | Where{$_.MobileClientDisplayVersion -eq ""}Zeige alle Benutzer, die noch eine alte Version des Desktop-Clients verwenden:
>Get-XpUsers | Where{$_.DesktopClientDisplayVersion -ne "9.0.311"}
Die im Beispiel genannte Version
9.0.311ist dabei durch die aktuellste Version des Systems zu ersetzen.Um gleichzeitig die zuletzt verwendete Version dieser Benutzer zu sehen:
>Get-XpUsers | Where{$_.DesktopClientDisplayVersion -ne "9.0.311"} | Select-Object -Property Firstname,Lastname,DesktopClientDisplayVersion
Set-XpUsers#
Syntax#
Set-XpUsers [[-Objects] <CFGUser[]>] [-Timeout <int>]
Beschreibung#
Set-XpUsers speichert die übergebenen CFGUser Objekte 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 deshalb unumgänglich.
Parameter#
-Objects <CFGUser[]>Spezifiziert die auf dem XPhone Connect Server zu speichernden Benutzer-Objekte.
-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.
Eingaben#
Der Eingabetyp ist der Typ der Objekte, die per Pipelining an Set-XpUsers übergeben werden können:
CFGUser
Ausgaben#
Der Befehl Set-XpUsers gibt keine Objekte zurück.
Beispiel#
Umbenennung der Abteilung Entwicklung in Software Development:
>Get-XpUsers | Where{$_.Department -eq "Entwicklung"} | foreach{$_.Department = "Software Development";$_} | Set-XpUsers
Erläuterung der Pipeline:
Der erste Schritt holt alle Benutzer vom XPhone Connect Server (
Get-XpUsers).Danach wird die Ergebnismenge nach der Abteilung mit dem Namen Entwicklung gefiltert (
Where {$_.Department -eq "Entwicklung"}).Anschließend wird bei all denjenigen Benutzern, die nach der Filterung noch übrig sind, die Abteilung zu „Software Development“ geändert (
foreach{$_.Department = "Software Development"}).Schließlich werden die Änderungen an den XPhone Connect Server übertragen und gespeichert (
Set-XpUsers).
Get-XpUsersFromADGroups#
Syntax#
Get-XpUsersFromADGroups [[-GroupNames] <String[]>] [-Timeout <int>]
Beschreibung#
Der Befehl gibt alle XPhone Connect Serverbenutzer zurück, die mit den Benutzern in den angegebenen Sicherheitsgruppen übereinstimmen.
Dies funktioniert nur bei Benutzern, die über den Active Directory-Connector in den XPhone Connect Server eingespielt wurden.
Alle Benutzer, die zwar in der Sicherheitsgruppe vorhanden sind, aber nicht auf dem XPhone Connect Server existieren (und umgekehrt), werden in den Ergebnissen nicht angezeigt.
Parameter#
-GroupNames <String[]>Namen der Sicherheitsgruppen, nach denen im Active Directory gesucht werden soll.
Die Groß- und Kleinschreibung spielt dabei keine Rolle, allerdings muss der volle Name angegeben werden. Heißt die Sicherheitsgruppe im AD also korrekt SicherheitsGruppe_123, so kann sie nicht als Sicherheitsgruppe, wohl aber als sicherheitsgruppe_123 angegeben 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.
Eingaben#
Dieser Befehl unterstützt keine Eingabe über die Pipeline und steht daher meist am Anfang einer Befehlskette.
Ausgaben#
Der Befehl Get-XpUsersFromADGroups gibt eine Liste vom Typ CFGUser[] zurück.
Siehe Get-XpUsers.
Beispiel#
Suche alle Benutzer auf dem XPhone Connect Server, die in der AD-Sicherheitsgruppe Vertrieb sind:
>Get-XpUsersFromADGroups "Vertrieb"
Setze für alle Benutzer aus der Sicherheitsgruppe English die Sprache des Clients auf Englisch:
>Get-XpUsersFromADGroups „English" | foreach{$_.Language = "en";$_} | Set-XpUsers
Achtung
Die in diesem Beispiel gezeigte Änderung der Sprache wird nur für den Benutzer wirksam, wenn er noch nie manuell in seinem Client eine Sprache eingestellt hat. Andernfalls hat die vom Benutzer selbst eingestellte Sprache Priorität.