New-CsSimpleUrlEntry
トピックの最終更新日: 2012-10-17
簡単な URL の新しいエントリを作成します。このエントリは、簡単な URL を作成する際に必要な要素です。簡単な URL を使用すると、ユーザーが会議に容易に参加したり、管理者が Microsoft Lync Server 2010 コントロール パネル に容易にログオンしたりできます。
構文
New-CsSimpleUrlEntry -Url <String>
解説
Microsoft Office Communications Server 2007 R2 では、会議の URL は次のようになります。
ただし、このような URL はわかりやすくはないため、他のメンバーに伝えやすいものではありません。Lync Server 2010 で導入された簡単な URL では、ユーザーに次のような URL を提供することで、これらの問題に対処できるようになりました。
https://meet.litwareinc.com/kenmyer/071200
簡単な URL は、Office Communications Server で使用されていた URL よりも明らかに改善されています。ただし、簡単な URL は自動的には作成されません。ユーザーが URL を構成する必要があります。また、各 URL のドメイン ネーム システム (DNS) レコードを作成したり、外部アクセスに対するリバース プロキシ ルールを構成したり、フロントエンド サーバー 証明書に簡単な URL を追加するなどの作業を行う必要があります。
Lync Server では、3 つの異なる簡単な URL を作成できます。
Meet – 会議に使用します。各 SIP ドメインに少なくとも 1 つの会議 URL がある必要があります。
Admin - 管理者に Lync Server 2010 コントロール パネル を示すために使用します。
Dialin - ダイヤルイン会議 Web ページに使用します。
簡単な URL は、簡単な URL 構成のコレクションに格納されます。Lync Server をインストールするときに、グローバル コレクションが作成されます。また、サイト スコープでカスタム コレクションを作成することもできます。これにより、サイトごとに異なる簡単な URL を使用できます。
簡単な URL のコレクションに実際の URL を追加するには、まず、New-CsSimpleUrl コマンドレットと New-CsSimpleUrlEntry コマンドレットを使用して URL を作成する必要があります。New-CsSimpleUrlEntry コマンドレットでは、URL エントリを作成します。これは、単に簡単な URL として (集会、管理、またはダイヤルイン会議用に) 使用できる URL (https://meet.litwareinc.com など) にすぎません。次に、New-CsSimpleUrlEntry で作成したオブジェクトを、新しい簡単な URL の SimpleUrlEntry プロパティに追加します。SimpleUrlEntry プロパティには複数の URL を保持できるため、オブジェクトを作成するには別のコマンドレットを使用する必要があります(ただし、アクティブな URL として指定できるのは、1 つの URL のみです。アクティブな URL とは、会議、管理、またはダイヤルイン会議用に使用する実際の URL のことです)。
簡単な URL のエントリを作成した後、New-CsSimpleUrl コマンドレットを使用して、簡単な URL のメモリ内専用インスタンスを作成します。この際、コンポーネント (簡単な URL の種類)、ドメイン、アクティブな URL、および簡単な URL のすべてのエントリなどを定義します。簡単な URL を表すオブジェクトを作成したら、そのオブジェクトを簡単な URL の新しいコレクションまたは既存のコレクションに追加できます。簡単な URL のコレクションを更新した後で、Enable-CsComputer コマンドレットを実行する必要があります。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、New-CsSimpleUrlEntry コマンドレットのローカル実行を承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSimpleUrlEntry"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Url |
必須 |
文字列 |
簡単な URL の SimpleUrlEntry プロパティに追加する URL。次に例を示します。-Url "https://meet.litwareinc.com"URL の先頭にプレフィックス "https:" を付ける必要があります。 |
入力の種類
なし。
戻り値の種類
New-CsSimpleUrlEntry は、Microsoft.Rtc.Management.WritableConfig.SimpleUtl.SimpleUrlEntry オブジェクトの新しいインスタンスを作成します。
例
-------------------------- 例 1 ------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry -ActiveUrl "https://meet.fabrikam.com"
Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl}
上記の例は、簡単な URL の既存のコレクションに新しい URL を追加する方法を示しています。まず、例の最初のコマンドで New-CsSimpleUrlEntry を使用して、https://meet.fabrikam.com を示す URL エントリを作成します。この URL エントリは $urlEntry という変数に格納されます。
2 番目のコマンドで、New-CsSimpleUrl を使用してメモリ内専用の簡単な URL のインスタンスを作成します。この例では、URL コンポーネントを Meet に、ドメインを fabrikam.com に、ActiveUrl を https://meet.fabrikam.com に設定しています。また、最初のコマンドで作成した URL エントリ $urlEntry を使用して、SimpleUrlEntry プロパティを $urlEntry に設定しています。
URL を作成して $simpleUrl というオブジェクト参照に格納した後に、例にある最後のコマンドで新しい URL を Redmond サイトの簡単な URL のコレクションに追加します。これを行うため、Set-CsSimpleUrlConfiguration コマンドレット、SimpleUrl パラメーター、およびパラメーター値 @{Add=$simpleUrl} を使用しています。この構文により、オブジェクト参照 $simpleUrl に格納されている URL を SimpleUrl プロパティに追加します。
-------------------------- 例 2 ------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$urlEntry2 = New-CsSimpleUrlEntry -Url "https://dialin.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrl $urlEntry -ActiveUrl "https://meet.fabrikam.com"
$simpleUrl2 = New-CsSimpleUrl -Component "dialin" -Domain "*" -SimpleUrl $urlEntry -ActiveUrl "https://dialin.fabrikam.com"
Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl, $simpleUrl2}
例 2 では、1 組の URL エントリを簡単な URL の既存のコレクションに追加します。これを行うため、例の最初のコマンドで New-CsSimpleUrlEntry を使用して、https://meet.fabrikam.com を示す URL エントリを作成します。この URL エントリは $urlEntry という変数に格納されます。次に、2 番目のコマンドで 2 番目の URL エントリを作成します。このエントリは変数 $urlEntry2 に格納され、https:// dialin.fabrikam.com という URL を示します。
2 つの URL エントリを作成した後、New-CsSimpleUrl を使用して簡単な URL のメモリ内専用インスタンスを作成します。最初のインスタンスでは、URL コンポーネントを Meet に、ドメインを fabrikam.com に、ActiveUrl を https://meet.fabrikam.com に設定しています。2 番目のインスタンスでは、コンポーネントを Dialin に、ドメインをアスタリスク (*) に、ActiveURL プロパティを https://dialin.fabrikam.com に設定しています。
URL を作成して $simpleUrl および $simpleUrl2 というオブジェクト参照に格納した後に、例にある最後のコマンドで新しい URL を Redmond サイトの簡単な URL のコレクションに追加します。これを行うため、Set-CsSimpleUrlConfiguration コマンドレット、SimpleUrl パラメーター、およびパラメーター値 @{Add=$simpleUrl, $simpleUrl2} を使用しています。この構文により、オブジェクト参照 $simpleUrl および $simpleUrl2 に格納されている URL を SimpleUrl プロパティに追加します。