New-CsSimpleUrlConfiguration
トピックの最終更新日: 2012-10-17
新しい簡単な URL の構成コレクションを作成します。簡単な URL を使用すると、ユーザーが会議に容易に参加できます。また、管理者が Microsoft Lync Server 2010 コントロール パネル にサインインしやすくなります。
構文
New-CsSimpleUrlConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SimpleUrl <PSListModifier>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]
解説
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 構成コレクションは、New-CsSimpleUrlConfiguration コマンドレットを使用して作成します。その後、さらに別のコマンドレット (New-CsSimpleUrl や Set-CsSimpleUrlConfiguration など) を使用して、これらのコレクションに簡単な URL を設定できます。簡単な URL のコレクションを更新した後で、Enable-CsComputer コマンドレットを実行する必要があります。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、New-CsSimpleUrlConfiguration コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSimpleUrlConfiguration"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
必須 |
Xds Identity |
新しい簡単な URL の構成コレクションの一意の識別子。新しいコレクションはサイト スコープでのみ作成できるため、Identity にはプレフィックス "site:" が付加され、その後にサイト名が続きます。たとえば、次の構文により、Redmond サイトの新しいコレクションが作成されます。-Identity "site:Redmond"。 |
SimpleUrl |
省略可能 |
PS リスト修飾子 |
このコレクションで構成されている簡単な URL。これらの URL は、New-SimpleUrl コマンドレットと New-SimpleUrlEntry コマンドレットを使用して作成する必要があります。 |
InMemory |
省略可能 |
スイッチ パラメーター |
永続的な変更としてオブジェクトをコミットせずに、オブジェクト参照を作成します。このパラメーターを指定して呼び出したコマンドレットの出力を変数に割り当てる場合、オブジェクト参照のプロパティを変更し、コマンドレットに対応する Set- コマンドレットを呼び出してそれらの変更をコミットできます。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
Tenant |
省略可能 |
Guid |
社内バージョンの Lync Server では、このパラメーターを使用しません。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
なし。
戻り値の種類
New-CsSimpleUrlConfiguration を実行すると、Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration オブジェクトの新しいインスタンスが作成されます。
例
-------------------------- 例 1 ------------------------
New-CsSimpleUrlConfiguration -Identity "site:Redmond"
例 1 に示すコマンドでは、Redmond サイトの新しい簡単な URL のコレクションを作成します。このコマンドには Identity 以外のパラメーターが指定されていないため、新しいコレクションには簡単な URL は含まれていません。Redmond サイトが既に簡単な URL のコレクションをホストしている場合、このコマンドは失敗します。
-------------------------- 例 2 ------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://dialin.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "dialin" -Domain "*" -SimpleUrlEntry $urlEntry -ActiveUrl "https://dialin.fabrikam.com"
$urlEntry2 = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl2 = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry2
New-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl,$simpleUrl2}
上記の例は、2 つの簡単 なURL (会議管理用とダイヤルイン会議用) を含む新しい簡単 なURL のコレクションの作成方法を示しています。これを実行するには、例の最初のコマンドで New-CsSimpleUrlEntry を使用して、https://dialin.litwareinc.com を示す URL エントリを作成します。この URL エントリは $urlEntry という変数に格納されます。次に、2 番目のコマンドで、https://meet.fabrikam.com を示す別の URL エントリを作成します。
さらに、New-CsSimpleUrl を使用して、簡単な URL のメモリ内専用インスタンスを作成します。この例では、URL コンポーネントをダイヤルイン、ドメインをアスタリスク (*)、ActiveUrl を https://dialin.fabrikam.com、および SimpleUrl プロパティを $urlEntry に設定します (変数 $urlEntry は、最初のコマンドで作成された URL エントリを表します)。次に、同様のコマンドを使用して、meet.fabrikam.com の簡単な URL を作成します。
URL を作成して $simpleUrl および $simpleUrl2 というオブジェクト参照に格納したら、例の最後のコマンドで Redmond サイトの新しい簡単な URL のコレクションを作成し、2 つの新しいメモリ内専用 URL をそのコレクションに追加します。新しい URL をコレクションに追加するには、New-CsSimpleUrlConfiguration コマンドレット、SimpleUrl パラメーター、およびパラメーター値 @{Add=$simpleUrl, $simpleUrl2} を使用します。この構文により、オブジェクト参照 $simpleUrl および $simpleUrl2 に格納されている URL を SimpleUrl プロパティに追加します。