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 Amberg“ an:
>Get-XpUsers "Anna Amberg"
Zeige alle Benutzer aus der Abteilung „Vertrieb“:
>Get-XpUsers | Where{$_.Department -eq "Vertrieb"}Zeige alle Benutzer, die den Mobile-Client 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.311“ ist 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.
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!