Set-CsNetworkSite
トピックの最終更新日: 2012-03-26
通話受付管理 (CAC) または Enhanced 9-1-1 (E9-1-1) に定義されている、既存のネットワーク サイトを変更します。
構文
Set-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-LocationPolicy <String>] [-NetworkRegionID <String>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkSite [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationPolicy <String>] [-NetworkRegionID <String>] [-WhatIf [<SwitchParameter>]]
解説
ネットワーク サイトは、CAC または E9-1-1 展開の各地域内で構成されるオフィスまたは拠点です。このコマンドレットは、既存のサイトの設定を変更します。これには、サイトが関連付けられている地域、サイトの説明、関連付けられている帯域ポリシー プロファイルなどを含めることができます。
このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーが、Set-CsNetworkSite コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkSite"}
パラメーター
| パラメーター | 必須 | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
XdsGlobalRelativeIdentity |
変更するネットワーク サイトの一意の識別子。サイトはグローバル スコープでのみ作成されるため、スコープを指定する必要はありません。代わりに、ネットワーク サイト ID のみを指定する必要があります。 |
Instance |
省略可能 |
DisplayNetworkSiteType |
ネットワーク サイト オブジェクト (Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType タイプのオブジェクト) への参照。このオブジェクトを取得するには、Get-CsNetworkSite コマンドレットを呼び出します。 |
BWPolicyProfileID |
省略可能 |
文字列 |
このサイトの制限事項を定義する帯域幅ポリシー プロファイルの ID。利用可能なプロファイルの一覧を取得するには、Get-CsNetworkBandwidthPolicyProfile コマンドレットを呼び出します。 このパラメーターの値を指定する場合は、NetworkRegionID パラメーターの値も指定する必要があります。 |
BypassID |
省略可能 |
文字列 |
グローバル一意識別子 (GUID)。この GUID を使用して、ネットワーク サイトを CAC または E9-1-1 ネットワーク構成内のメディア バイパスの設定にマップします (New-CsNetworkMediaBypassConfiguration を呼び出すときに、この BypassID の値を使用します)。 このパラメーターの値を指定する場合は、NetworkRegionID パラメーターの値も指定する必要があります。このパラメーターの値を指定しなくても、NetworkRegionID を指定すると、BypassID が自動的に生成されます。 値を明示的に指定する場合は、GUID の形式 (たとえば、3b24a047-dce6-48b2-9f20-9fbff17ed62a) で指定する必要があります。NetworkRegionID の値を入力して、BypassID 値が自動生成されるようにすることをお勧めします。値を手動で入力すると、値を自動生成しないことを確認する確認プロンプトが表示されます。 |
Description |
省略可能 |
文字列 |
サイトの説明を示す文字列。このパラメーターを使用することにより、サイトの目的や存在する場所について、Identity だけで表現可能な情報よりも詳細な説明を入力することができます。 |
LocationPolicy |
省略可能 |
文字列 |
このサイトに関連付けられている場所ポリシーの名前。場所のポリシーは、特定の E9-1-1 設定をサイトに割り当てます。場所のポリシーの一覧を取得するには、Get-CsLocationPolicy コマンドレットを呼び出します。 |
NetworkRegionID |
省略可能 |
文字列 |
このサイトが関連付けられているネットワーク領域の ID。BypassID を (自動生成または手動で) 入力する場合、またはネットワーク構成の EnableBandwidthPolicyCheck プロパティが True の場合は、このパラメーターに値を指定する必要があります。ネットワーク構成の設定を取得するには、Get-CsNetworkConfiguration コマンドレットを呼び出します。 このサイトに BypassID が既に存在するときに BypassID パラメーターの値を指定しないと、既存の BypassID は自動生成された BypassID によって上書きされます。 |
Force |
省略可能 |
SwitchParameter |
変更を行う前に表示されるように設定されているすべての確認メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType オブジェクト。ネットワーク サイト オブジェクトのパイプ処理された入力を受け入れます。
戻り値の種類
このコマンドレットには戻り値はありません。Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 型のオブジェクトを変更します。
例
-------------------------- 例 1 --------------------------
Set-CsNetworkSite -Identity Vancouver -NetworkRegionID Canada
この例では、Vancouver という名前のネットワーク サイトが変更されます。変更されるサイトの名前は、Identity パラメーターの値として指定されます。Vancouver サイトは新しい領域に移動されますが、それには、NetworkRegionID パラメーターを変更する必要があります。この場合は、Canada という名前の領域に変更されます。NetworkRegionID が入力されていても、BypassID の値が指定されていないため、BypassID 値が自動的に生成されます。既存の BypassID はすべて上書きされます。
-------------------------- 例 2 --------------------------
Set-CsNetworkSite -Identity Vancouver - BWPolicyProfileID LowBWLimits
例 2 では、Vancouver サイトに関連付けられている帯域幅ポリシー プロファイルのみを変更します。サイト名は、Identity パラメーターの値として指定されます。次に、BWPolicyProfileID パラメーターに次の値を指定します。LowBWLimits。そのプロファイルに関連付けられているポリシーは、このサイトで使用されます。