Set-CsUser
Letztes Änderungsdatum des Themas: 2012-03-26
Ändert Microsoft Lync Server 2010-Eigenschaften für ein vorhandenes Benutzerkonto. Sie können nur Eigenschaften für Konten ändern, die für die Verwendung mit Lync Server 2010 aktiviert wurden.
Syntax
Set-CsUser -Identity <UserIdParameter> [-AcpInfo <MultiValuedProperty>] [-AudioVideoDisabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-HostedVoiceMail <Nullable>] [-LineServerURI <String>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrivateLine <String>] [-RemoteCallControlTelephonyEnabled <$true | $false>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Über Set-CsUser können die in Active Directory-Domänendienste (AD DS) gespeicherten Lync Server-bezogenen Benutzerkontoattribute geändert werden. Sie können einen Benutzer z. B. für Lync Server deaktivieren oder erneut aktivieren, für die Audio-/Videokommunikation (A/V) aktivieren oder deaktivieren oder die Nummer der Privatleitung eines Benutzers sowie den Anschluss-URI ändern. Set-CsUser kann nur für Benutzer verwendet werden, die für Lync Server aktiviert wurden.
Mit Set-CsUser können Sie nur Lync Server-bezogene Attribute ändern. Andere Benutzerkontoattribute, wie die Position oder die Abteilung des Benutzers, können über dieses Cmdlet nicht geändert werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Set-CsUser lokal auszuführen: RTCUniversalUserAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUser\b"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Gibt die Identität des zu ändernden Benutzerkontos an. Benutzeridentitäten können in den folgenden vier Formaten angegeben werden: als 1) SIP-Adresse des Benutzers, 2) UPN (User Principal Name) des Benutzers, 3) Domänen- und Anmeldename des Benutzers (mit dem Format "Domäne\Anmeldename", z. B. "litwareinc\kenmyer") und 4) Active Directory-Anzeigename des Benutzers (z. B. "Ken Myer"). Benutzeridentitäten können auch über den Active Directory-DN (Distinguished Name) des Benutzers referenziert werden. Sie können das Sternchen (*) als Platzhalterzeichen nutzen, wenn Sie den Anzeigenamen als Benutzeridentität verwenden. Der Identitätswert "* Smith" gibt beispielsweise alle Benutzer zurück, deren Anzeigename auf den Zeichenfolgenwert " Smith" endet. |
ACPInfo |
Optional |
Mehrere ACPInfo-Objekte |
Ermöglicht das Zuweisen von einem oder mehreren Drittanbieter-Audiokonferenzanbietern zu einem Benutzer. Es empfiehlt sich jedoch, das Cmdlet Set-UserAcp für die Zuweisung von Audiokonferenzanbietern zu verwenden. |
AudioVideoDisabled |
Optional |
Boolescher Wert |
Gibt an, ob der Benutzer Audio-/Videoanrufe (A/V) über Lync 2010 tätigen kann. Wenn "True" festgelegt ist, ist der Benutzer weitgehend auf das Senden und Empfangen von Sofortnachrichten beschränkt. Die Audio-/Videokommunikation kann nicht deaktiviert werden, wenn ein Benutzer gegenwärtig für die Remoteanrufsteuerung, Enterprise-VoIP und/oder IP-PBX-Softphone-Routing (Internet Protocol Private Branch Exchange) aktiviert ist. |
Enabled |
Optional |
Boolescher Wert |
Gibt an, ob der Benutzer für Lync Server aktiviert ist. Wenn dieser Wert auf "False" gesetzt wird, kann der Benutzer sich nicht länger bei Lync Server anmelden. Bei Festlegung auf "True" werden die Anmeldeberechtigungen des Benutzers wieder aktiviert. Wenn Sie ein Konto über den Parameter "Enabled" deaktivieren, werden die diesem Konto zugeordneten Informationen (einschließlich der zugewiesenen Richtlinien sowie der Information, ob der Benutzer für Enterprise-VoIP und die Remoteanrufsteuerung aktiviert ist oder nicht) beibehalten. Wird das Konto zu einem späteren Zeitpunkt über den Parameter "Enabled" wieder aktiviert, werden die zugeordneten Kontoinformationen wiederhergestellt. Dieses Verhalten unterscheidet sich von der Verwendung des Cmdlets Disable-CsUser zur Deaktivierung eines Benutzerkontos. Bei der Ausführung von Disable-CsUser werden alle dem Konto zugeordneten Lync Server-Daten gelöscht. |
DomainController |
Optional |
Zeichenfolge |
Ermöglicht die Angabe eines Domänencontrollers, mit dem beim Ändern eines Benutzerkontos eine Verbindung hergestellt werden soll. Wenn dieser Parameter nicht angegeben wird, verwendet das Cmdlet den ersten verfügbaren Domänencontroller. |
EnterpriseVoiceEnabled |
Optional |
Boolescher Wert |
Gibt an, ob der Benutzer für Enterprise-VoIP aktiviert wurde, die Microsoft-Implementierung von VoIP (Voice over Internet Protocol). Mit Enterprise-VoIP können Benutzer Anrufe über das Internet tätigen anstatt das standardmäßige Telefonnetz zu nutzen. |
HostedVoiceMail |
Optional |
Boolescher Wert |
Bei Festlegung auf "True" können die Voicemailanrufe eines Benutzers an eine gehostete Version von Microsoft Exchange Server weitergeleitet werden. Ferner können Lync 2010-Benutzer bei Auswahl von "True" die Voicemail eines anderen Benutzers direkt anrufen. |
LineURI |
Optional |
Zeichenfolge |
Die dem Benutzer zugewiesene Telefonnummer. Der Anschluss-URI (Uniform Resource Identifier) muss im E.164-Format angegeben werden und mit dem Präfix "TEL:" beginnen. Beispiel: TEL:+14255551297. Durchwahlnummern werden am Ende des Anschluss-URI hinzugefügt. Beispiel: TEL:+14255551297; ext=51297. Wichtig ist der Hinweis, dass Lync Server "TEL:+14255551297" und "TEL:+14255551297;ext=51297" als zwei verschiedene Nummern behandelt. Wenn Sie Ken Myer den Anschluss-URI "TEL:+14255551297" zuweisen und später versuchen, Pilar Ackerman den Anschluss-URI "TEL:+14255551297;ext=51297" zuzuweisen, hat diese Zuweisung Erfolg, denn die Pilar zugewiesene Nummer wird nicht als Duplikat gekennzeichnet. Ursache ist die Tatsache, dass je nach Einrichtung diese beiden Nummer tatsächlich unterschiedlich sein können. In einigen Organisationen wird Ihr Anruf beim Wählen von "1-425-555-1297" an eine automatische Telefonzentrale von Exchange weitergeleitet. Beim Wählen von bloß der Durchwahl (51297) oder Verwenden von Microsoft Lync 2010 zum Wählen der Nummer "1-425-555-1297 Durchwahl 51297" wird der Anruf direkt zum Benutzer weitergeleitet. |
LineServerURI |
Optional |
Zeichenfolge |
Der URI des Telefongateways für die Remoteanrufsteuerung, das dem Benutzer zugeordnet ist. Bei "LineServerUri" handelt es sich um den Gateway-URI, dem "sip:" vorangestellt ist. Beispiel: sip:rccgateway@litwareinc.com |
PrivateLine |
Optional |
Zeichenfolge |
Die Telefonnummer der Privatleitung eines Benutzers. Bei einer Privatleitung handelt es sich um eine Telefonnummer, die nicht in Active Directory-Domänendienste (AD DS) veröffentlicht ist und daher nicht problemlos von anderen Benutzern verwendet werden kann. Darüber hinaus umgeht diese Privatleitung die meisten Routingregeln für eingehende Anrufe. So wird ein Anruf an eine Privatleitung z. B. nicht an die Stellvertreter eines Benutzers weitergeleitet. Privatleitungen werden häufig für private Anrufe oder geschäftliche Telefonate verwendet, die unabhängig und getrennt von den anderen Teammitgliedern getätigt werden. Der Wert der Privatleitung muss im E.164-Format angegeben werden und über das Präfix "TEL:" verfügen. Beispiel: TEL:+14255551297. |
RemoteCallControlTelephonyEnabled |
Optional |
Boolescher Wert |
Gibt an, ob der Benutzer für die Remoteanrufsteuerungs-Telefonie aktiviert ist. Wenn ein Benutzer für die Remoteanrufsteuerung aktiviert ist, kann er Anrufe auf seinem Bürotelefon über Lync Server beantworten. Ferner können über Lync 2010 Anrufe getätigt werden. Für all diese Anrufe wird das Standardtelefonnetz, auch als Telefonfestnetz bekannt, verwendet. Um Anrufe über das Internet zu tätigen oder entgegenzunehmen, muss der Benutzer für Enterprise-VoIP aktiviert werden. Einzelheiten finden Sie in den Informationen zum Parameter "EnterpriseVoiceEnabled". Um für die Remoteanrufsteuerung aktiviert zu werden, muss ein Benutzer sowohl über einen "LineUri" als auch über einen "LineServerUri" verfügen. |
SipAddress |
Optional |
Zeichenfolge |
Eindeutige ID (vergleichbar mit einer E-Mail-Adresse), der einem Benutzer die Kommunikation über SIP-Geräte wie Lync 2010 ermöglicht. Die SIP-Adresse muss das Präfix "sip:" sowie eine gültige SIP-Domäne verwenden. Beispiel: -SipAddress sip:kenmyer@litwareinc.com. |
PassThru |
Optional |
Switch-Parameter |
Ermöglicht das Weiterleiten eines Benutzerobjekts für den Benutzer, dessen Konto geändert wird. Das Cmdlet Set-CsUser leitet standardmäßig keine Objekte weiter. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Zeichenfolge oder Microsoft.Rtc.Management.ADConnect.Schema.ADUser-Objekt. Set-CsUser akzeptiert einen weitergeleiteten Zeichenfolgenwert, der die Identität eines für Lync Server aktivierten Benutzers darstellt. Das Cmdlet akzeptiert auch weitergeleitete Instanzen des Active Directory-Benutzerobjekts.
Rückgabetypen
Set-CsUser gibt keine Objekte zurück.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsUser -Identity "Pilar Ackerman" -EnterpriseVoiceEnabled $True
In Beispiel 1 wird Set-CsUser zum Ändern des Benutzerkontos mit der Identität "Pilar Ackerman" verwendet. In diesem Fall wird das Konto geändert, um Enterprise-VoIP zu aktivieren, die Microsoft-Implementierung von VoIP. Zum Ausführen dieser Aufgabe wird der Parameter "EnterpriseVoiceEnabled" hinzugefügt, und der Wert wird auf "$True" gesetzt.
-------------------------- Beispiel 2 --------------------------
Get-CsUser -LdapFilter "Department=Finance" | Set-CsUser -EnterpriseVoiceEnabled $True
In Beispiel 2 werden die Konten aller Benutzer in der Abteilung "Finance" für Enterprise-VoIP aktiviert. In diesem Befehl werden zunächst das Cmdlet Get-CsUser und der Parameter "LDAPFilter" verwendet, um eine Sammlung aller Benutzer in der Abteilung "Finance" zurückzugeben. Diese Informationen werden anschließend an das Cmdlet Set-CsUser weitergeleitet, um Enterprise-VoIP für alle Konten in der Sammlung zu aktivieren.