Enable-CsUser
トピックの最終更新日: 2012-03-23
Microsoft Lync Server 2010 で 1 ユーザー以上を有効にします。ユーザーは Lync Server でユーザー アカウントが有効化されるまで、Microsoft Lync 2010 またはその他の Lync Server 2010 クライアントを使用できません。
構文
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>]]
解説
ユーザーが Lync Server にログオンするには、2 つの要件を満たす必要があります。有効な Active Directory アカウントを持つことと、そのアカウントが Lync Server で有効であることです。ユーザー アカウントを Lync Server で有効にする方法の 1 つは、Enable-CsUser コマンドレットの使用です。このコマンドレットを使用して Lync Server でアカウントを有効にするには、次のことを行う必要があります。1) 有効にするアカウントを 1 つまたは複数選択します。2) アカウントのレジストラー プールを選択します。3) アカウントに SIP アドレスを割り当てます。Lync Server では、管理者がユーザーに特定の SIP アドレスを割り当てるか、Lync Server に代わりに SIP アドレスを作成させるかを管理者が選択できます。
このコマンドレットを実行できるユーザー: 既定では、Enable-CsUser コマンドレットをローカルで実行する権限があるのは、RTCUniversalUserAdmins グループのメンバーです。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Enable-CsUser"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
必須 |
UserIDParameter |
Lync Server で有効にするユーザー アカウントの Identity を指定します。ユーザーの Identity は、以下の 4 つの形式のうちの 1 つを使用して指定できます。1) ユーザーの SIP アドレス、2) ユーザーのユーザー プリンシパル名 (UPN)、3) ドメイン\ログオン形式のユーザーのドメイン名とログオン名 (litwareinc\kenmyer など)、および 4) ユーザーの Active Directory 表示名 (Ken Myer など) です。また、ユーザーの Active Directory 識別名を使用して、ユーザー アカウントを参照することもできます。 表示名をユーザーの Identity として使用する場合は、アスタリスク (*) ワイルドカード文字を使用できます。たとえば、"* Smith" という Identity は、末尾が " Smith" という文字列値の表示名を持つすべてのユーザーを戻します。 |
RegistrarPool |
必須 |
FQDN |
ユーザーの Lync Server アカウントが所属するレジストラー プールを指定します。 |
SipAddressType |
省略可能 |
文字列 |
Lync Server に対して、新しいユーザーの SIP アドレスを自動生成するよう指示します。Lync Server が SIP アドレスを自動生成するよう設定するには、SipAddressType パラメーターを追加して以下のパラメーター値のうちの 1 つを使用します。 FirstLastName。ユーザーの名の後にピリオドが付き、その後に姓と SIP ドメインが付いたものが SIP アドレスとなります。たとえば、Ken Myer というユーザーの SIP アドレスは Ken.Myer@litwareinc.com のようになります。このアドレスの種類を使用する場合は、SipDomain パラメーターも追加する必要があります。 EmailAddress。(Active Directory で定義されている) ユーザーの電子メール アドレスが SIP アドレスとして使用されます。 UserPrincipalName。ユーザーの UPN が SIP アドレスとして使用されます。 SamAccountName。ユーザーの SamAccountName (ログオン名) の後に SIP ドメインが付いたものが SIP アドレスとなります。たとえば、kmyer という SamAccountName を持つユーザーの SIP アドレスは kmyer@litwareinc.com のようになります。このアドレスの種類を使用する場合は、SipDomain パラメーターも追加する必要があります。 SIPAddress パラメーターを使用しており、SIP アドレスを明示的に割り当てている場合は、SipAddressType パラメーターは不要です。 |
SipDomain |
省略可能 |
文字列 |
ユーザー アカウントの SIP ドメインを有効にしています。SIPAddressType パラメーターを使用して Lync Server にユーザーの SIP アドレスを自動生成させる場合や、SamAccountName またはユーザーの姓名に基づく SIP アドレスを使用した場合、このパラメーターは必須です。ユーザーの電子メール アドレスまたは UPN に基づく SIP アドレスを使用する場合、このパラメーターは不要です。ドメイン名は既にこれらの属性値に含まれているからです。 |
SipAddress |
省略可能 |
文字列 |
ユーザーに特定の SIP アドレスを割り当てることができます。SIP アドレスを指定する際は、アドレスの先頭に "sip:" を付けます。つまり、SipAddress パラメーターに指定された値は、次のように表示されます。 sip:kenmyer@litwareinc.com SipAddressType パラメーターを使用して Lync Server にユーザーの SIP アドレスの自動生成させる場合は、SipAddress パラメーターは使用しないでください。 複数のユーザーを同時に有効にしようとしている場合、SipAddress パラメーターは使用できません。代わりに、SipAddressType パラメーターを使用して、それらのユーザーの SIP アドレスを自動生成する必要があります。 |
HostingProviderProxyFqdn |
省略可能 |
文字列 |
このパラメーターは Microsoft Lync Online 2010 のみで使用します。このパラメーターを Lync Server の社内実装で使用しないでください。 |
ProxyPool |
省略可能 |
文字列 |
このパラメーターは Lync Online 2010 のみで使用します。このパラメーターを Lync Server の社内実装で使用しないでください。 |
DomainController |
省略可能 |
文字列 |
指定したドメイン コントローラーに接続して、ユーザー アカウントを有効にすることができます。特定のドメイン コントローラーに接続するには、DomainController パラメーターの後に、コンピューター名 (atl-cs-001 など) またはその完全修飾ドメイン名 (FQDN) (atl-cs-001.litwareinc.com など) を指定します。 |
PassThru |
省略可能 |
スイッチ パラメーター |
Lync Server で有効になっているユーザー アカウントを表すユーザー オブジェクトを、パイプラインを介して渡せるようにします。既定では、Enable-CsUser コマンドレットはパイプラインを介してオブジェクトを渡しません。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
文字列または Microsoft.Rtc.Management.ADConnect.Schema.ADUser オブジェクトです。Enable-CsUser は、Lync Server で有効になっているユーザー アカウントの Identity を表す文字列値をパイプ処理で受け入れます。また、Active Directory ユーザー オブジェクトのインスタンスをパイプ処理で受け入れます。
戻り値の種類
なし。Enable-CsUser は、値またはオブジェクトを戻しません。代わりに、Microsoft.Rtc.Management.ADConnect.Schema.ADUser オブジェクトのインスタンスを構成します。
例
-------------------------- 例 1 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
例 1 では、Enable-CsUser を使用して Pilar Ackerman という表示名を持つユーザー アカウントを有効にしています。この例では、atl-cs-001.litwareinc.com というレジストラー プールにユーザーを割り当て、ユーザーの SamAccountName (pilar) の後に SIP ドメイン litwareinc.com が続く SIP アドレスを、Lync Server で自動生成しています。
-------------------------- 例 2 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddress "sip:pilar@litwareinc.com"
上記の例では、Pilar Ackerman に属する Active Directory ユーザー アカウントを Lync Server で使用できるようにしています。Lync Server のアカウントを構成するために、次のパラメーターを Enable-CsUser と共に使用しています。Identity (有効にするアカウントを識別します)、RegistrarPool (ユーザーのホーム サーバーである Standard Edition サーバーまたは Enterprise Edition フロント エンド プールを示します)、SipAddress (新しいユーザーの SIP アドレスを指定します)。この場合、SIP アドレスは明示的に割り当てられます。Lync Server をアドレスの自動生成に使用することはありません。
-------------------------- 例 3 --------------------------
Get-CsAdUser -LDAPFilter "department=Finance" | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
例 3 では、財務部門の全ユーザーのアカウントで Lync Server を有効にしています。このタスクを実行するため、Get-CsAdUser コマンドレットを LDAPFilter パラメーターと共に使用し、財務部門に勤務している全ユーザーのコレクションを戻しています。次にこの情報を Enable-CsUser にパイプ処理して、コレクション内の各アカウントを Lync Server で有効にしています。
アカウントを有効にするため、ユーザーのレジストラー プールと SIP アドレスを指定する必要があります。この例では、RegistrarPool パラメーターを使用してレジストラー プールを指定しています。ただし、SIP アドレスは直接割り当てられていません。代わりに、SipAddressType と SipDomain の 2 つのパラメーターがコマンドに追加されています。つまり、ユーザーの SamAccountName と SIP ドメイン名で構成される新しい SIP アドレスが、アカウントごとに自動生成されます。たとえば、kenmyer という SamAccountName を持つユーザーの場合、SIP アドレスは sip:kenmyer@litwareinc.com となります。
-------------------------- 例 4 --------------------------
Get-CsAdUser -Filter {Enabled -ne $True} | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
上記のコマンドを実行すると、Lync Server でまだ有効になっていない、すべての Active Directory ユーザーが有効になります。これを実行するには、Get-CsAdUser コマンドレットをフィルター パラメーターと一緒に起動します。フィルター {Enabled -ne $True} により、Lync Server で有効になっていないすべてのユーザーのコレクションを戻します。次にこのコレクションを Enable-CsUser にパイプ処理しています。この結果各アカウントが有効になり、ユーザーがレジストラー プール atl-cs-001.litwareinc.com に割り当てられて、各ユーザーの SIP アドレスが自動生成されます。