Enable-CsUser
Letztes Änderungsdatum des Themas: 2012-03-23
Aktiviert einen oder mehrere Benutzer für Microsoft Lync Server 2010. Benutzer können Microsoft Lync 2010 oder andere Lync Server 2010-Clients erst verwenden, nachdem ihre Benutzerkonten für Lync Server aktiviert wurden.
Syntax
Enable-CsUser -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HostingProviderProxyFqdn <Fqdn>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-RegistrarPool <Fqdn>] [-SipAddress <String>] [-SipAddressType <FirstLastName | EmailAddress | UserPrincipalName | SAMAccountName | None>] [-SipDomain <Fqdn>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Um sich bei Lync Server anmelden zu können, muss ein Benutzer zwei Anforderungen erfüllen: Er muss ein gültiges Active Directory-Konto besitzen, und dieses Konto muss für Lync Server aktiviert sein. Eine Möglichkeit zum Aktivieren eines Benutzerkontos für Lync Server bietet das Cmdlet Enable-CsUser. Zur Verwendung dieses Cmdlets zum Aktivieren eines Kontos für Lync Server sind folgende Schritte erforderlich: 1) Auswählen des Kontos bzw. der Konten für die Aktivierung; 2) Auswählen eines Registrierungspools für das Konto; 3) Zuweisen des Kontos zu einer SIP-Adresse. In Lync Server können Administratoren dem Benutzer eine spezifische SIP-Adresse zuweisen oder über Lync Server eine SIP-Adresse erstellen lassen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Enable-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 "Enable-CsUser"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
UserIDParameter |
Gibt die Identität des Benutzerkontos an, das für Lync Server aktiviert werden soll. 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"). Sie können auch unter Verwendung des Active Directory-Distinguished Name (DN) des Benutzers auf ein Benutzerkonto verweisen. 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. |
RegistrarPool |
Erforderlich |
FQDN |
Gibt den Registrierungspool an, in den das Lync Server-Konto des Benutzers aufgenommen wird. |
SipAddressType |
Optional |
Zeichenfolge |
Weist Lync Server an, automatisch eine SIP-Adresse für den neuen Benutzer zu generieren. Um die SIP-Adresse automatisch von Lync Server generieren zu lassen, muss der Parameter "SipAddressType" angegeben und einer der folgenden Parameterwerte verwendet werden: FirstLastName. Die SIP-Adresse besteht aus dem Vornamen des Benutzers und einem Punkt, auf den der Nachname des Benutzers und die SIP-Domäne folgt. Die SIP-Adresse von Ken Myer könnte z. B. wie folgt lauten: Ken.Myer@litwareinc.com. Wenn Sie diesen Adresstyp verwenden, müssen Sie auch den Parameter "SipDomain" verwenden. EmailAddress. Die E-Mail-Adresse des Benutzers (gemäß Definition in Active Directory) wird als SIP-Adresse verwendet. UserPrincipalName. Der UPN des Benutzers wird als SIP-Adresse verwendet. SamAccountName. Als SIP-Adresse wird der Wert von "SamAccountName" (Anmeldename) des Benutzers verwendet, auf den die SIP-Domäne folgt. Wenn der Wert von "SamAccountName" eines Benutzers z. B. "kmyer" lautet, könnte die SIP-Adresse wie folgt lauten: kmyer@litwareinc.com. Wenn Sie diesen Adresstyp verwenden, müssen Sie auch den Parameter "SipDomain" verwenden. Der Parameter "SipAddressType" ist nicht erforderlich, wenn Sie den Parameter "SIPAddress" verwenden und dem Benutzer explizit eine SIP-Adresse zuweisen. |
SipDomain |
Optional |
Zeichenfolge |
Die SIP-Domäne für das Benutzerkonto, das aktiviert wird. Dieser Parameter ist erforderlich, wenn Sie den Parameter "SIPAddressType" verwenden, um automatisch von Lync Server eine SIP-Adresse für den Benutzer generieren zu lassen, und wenn SIP-Adressen auf dem Wert von "SamAccountName" oder dem Vor- und Nachnamen des Benutzer basieren. Dieser Parameter ist nicht erforderlich, wenn Ihre SIP-Adressen auf den E-Mail-Adressen der Benutzer oder auf den Benutzerprinzipalnamen (UPN) basieren, da der Domänenname in diesen Attributwerten bereits enthalten ist. |
SipAddress |
Optional |
Zeichenfolge |
Ermöglicht Ihnen, dem Benutzer eine spezifische SIP-Adresse zuzuweisen. Stellen Sie beim Angeben der SIP-Adresse die Zeichenfolge "sip:" voran. Der für den Parameter "SipAddress" angegebene Wert sollte demnach in etwa wie folgt aussehen: sip:kenmyer@litwareinc.com Der Parameter "SipAddress" sollte nicht verwendet werden, wenn Sie den Parameter "SipAddressType" einsetzen, um die SIP-Adresse für einen Benutzer automatisch von Lync Server generieren zu lassen. Der Parameter "SipAddress" kann nicht verwendet werden, wenn Sie versuchen, mehrere Benutzer gleichzeitig zu aktivieren. Stattdessen müssen Sie die SIP-Adresse für solche Benutzer über den Parameter "SipAddressType" automatisch generieren lassen. |
HostingProviderProxyFqdn |
Optional |
Zeichenfolge |
Dieser Parameter wird nur für Microsoft Lync Online 2010 verwendet. Er sollte nicht mit einer lokalen Implementierung von Lync Server verwendet werden. |
ProxyPool |
Optional |
Zeichenfolge |
Dieser Parameter wird nur für Lync Online 2010 verwendet. Er sollte nicht mit einer lokalen Implementierung von Lync Server verwendet werden. |
DomainController |
Optional |
Zeichenfolge |
Ermöglicht es Ihnen, zum Aktivieren eines Benutzerkontos eine Verbindung mit dem angegebenen Domänencontroller herzustellen. Zum Herstellen einer Verbindung mit einem bestimmten Domänencontroller nehmen Sie den Parameter "DomainController" auf und geben anschließend den Computernamen (z. B. "atl-cs-001") oder den vollqualifizierten Domänennamen (z. B. "atl-cs-001.litwareinc.com") an. |
PassThru |
Optional |
Switch-Parameter |
Ermöglicht das Weiterleiten eines Benutzerobjekts für das Benutzerkonto, das für Lync Server aktiviert wird. Das Cmdlet Enable-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. Enable-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
Keine. Enable-CsUser gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.ADUser" konfiguriert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
In Beispiel 1 wird Enable-CsUser zum Aktivieren des Benutzerkontos mit dem Anzeigenamen "Pilar Ackerman" verwendet. In diesem Beispiel wird die Benutzerin dem Registrierungspool "atl-cs-001.litwareinc.com" zugewiesen, und Lync Server generiert automatisch die SIP-Adresse anhand der Eigenschaft "SamAccountName" der Benutzerin (pilar), gefolgt von der SIP-Domäne "litwareinc.com".
-------------------------- Beispiel 2 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddress "sip:pilar@litwareinc.com"
Im vorangehenden Beispiel wird das Benutzerkonto von Pilar Ackerman in Active Directory für die Verwendung mit Lync Server aktiviert. Um das Konto für Lync Server zu aktivieren, werden die folgenden Parameter mit Enable-CsUser verwendet: "Identity", zur Identifizierung des Kontos, das aktiviert werden soll; "RegistrarPool", zur Angabe des Standard Edition-Servers oder Enterprise Edition-Front-End-Pools, in dem der Benutzer verwaltet wird; und "SipAddress", zur Festlegung der SIP-Adresse für den neuen Benutzer. In diesem Fall wird die SIP-Adresse explizit zugewiesen und nicht von Lync Server automatisch generiert.
-------------------------- Beispiel 3 --------------------------
Get-CsAdUser -LDAPFilter "department=Finance" | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
In Beispiel 3 werden die Konten aller Benutzer in der Abteilung "Finance" für Lync Server aktiviert. Hierzu wird das Cmdlet Get-CsAdUser mit dem Parameter "LDAPFilter" verwendet, um eine Auflistung aller Benutzer in der Abteilung "Finance" zurückzugeben. Diese Informationen werden anschließend an Enable-CsUser weitergeleitet, um jedes Konto in der Auflistung für Lync Server zu aktivieren.
Zum Aktivieren eines Kontos müssen Sie den Registrierungspool und die SIP-Adresse des Benutzers angeben. In diesem Beispiel wird der Registrierungspool über den Parameter "RegistrarPool" angegeben. Die SIP-Adresse wird jedoch nicht direkt zugewiesen. Stattdessen werden zwei Parameter, "SipAddressType" und "SipDomain", zum Befehl hinzugefügt. Dies bedeutet, dass für jedes Konto automatisch eine neue SIP-Adresse aus dem Wert von "SamAccountName" eines Benutzers und dem SIP-Domänennamen generiert wird. Ein Benutzer mit dem Wert "kenmyer" für "SAMAccountName" erhält beispielsweise die SIP-Adresse "sip:kenmyer@litwareinc.com".
-------------------------- Beispiel 4 --------------------------
Get-CsAdUser -Filter {Enabled -ne $True} | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
Mit dem vorstehenden Befehl werden alle Active Directory-Benutzer für Lync Server aktiviert, für die bisher noch keine Aktivierung durchgeführt wurde. Hierzu wird das Cmdlet Get-CsAdUser mit dem Parameter "Filter" aufgerufen. Der Filter {Enabled -ne $True} gibt eine Auflistung aller Benutzer zurück, die nicht für Lync Server aktiviert wurden. Diese Auflistung wird anschließend an Enable-CsUser weitergeleitet. Dieses Cmdlet aktiviert die Konten, weist die Benutzer dem Registrierungspool "atl-cs-001.litwareinc.com" zu und generiert automatisch eine SIP-Adresse für jeden Benutzer.