Set-CsTestDevice
トピックの最終更新日: 2012-03-25
組織で使用するために構成されている、1 つ以上のデバイス更新プログラム管理テスト デバイスを変更します。管理者はテスト デバイスを使用することで、組織内のすべてのデバイスに更新プログラムを配布する前に、ファームウェアの更新プログラムをテストすることができます。
構文
Set-CsTestDevice [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Identifier <String>] [-IdentifierType <MACAddress | SerialNumber>] [-WhatIf [<SwitchParameter>]]
Set-CsTestDevice [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Identifier <String>] [-IdentifierType <MACAddress | SerialNumber>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
解説
Microsoft Lync 2010 Phone Edition を実行している特定の電話機やその他のデバイスをテスト デバイスとして識別することにより、管理者はファームウェアの更新を、組織内の該当するすべてのデバイスに展開する前に確認して承認することができます。デバイス更新のルールが Microsoft Lync Server 2010 にインポートされると、そのルールは "保留" とマークされます。これはそのルールに対応する更新が、影響を受けるデバイスにより、自動的にダウンロードおよびインストールされないことを示します。
代わりに、関連するテスト デバイスがこの保留中のルールをダウンロードしてインストールします。テスト デバイスの背後にある意図は次のとおりです。新しいデバイス更新ルールがテスト デバイスに自動的に適用されるため、管理者は、ファームウェア更新プログラムが正常に動作するかどうかを確認することができます。予想通りに動作する場合、管理者はそのルールを承認済みとしてマークできます。その後、承認済みルールは組織内の該当するすべてのデバイスによりダウンロードおよびインストールされます。
テスト デバイスは New-CsTestDevice コマンドレットを使用して作成します。テスト デバイスを作成したら、Set-CsTestDevice コマンドレットを使用して、そのデバイスまたは他のテスト デバイスの識別子および IdentifierType を変更できます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが、Set-CsTestDevice コマンドレットをローカルで実行することを承認されています。RTCUniversalServerAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsTestDevice"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Identity |
省略可能 |
Xds Identity |
変更するテスト デバイスの Identity を指定します。次に例を示します。-Identity site:Redmond/UCPhoneTestDevice。Identity 指定時はワイルドカードを使用できないことに注意してください。 |
Instance |
省略可能 |
テスト デバイス オブジェクト |
個々のパラメーター値を設定するのではなく、オブジェクトへの参照をコマンドレットに渡せるようにします。 |
Identifier |
必須 |
文字列 |
IdentifierType に基づいて、新しいテスト デバイスのメディア アクセス制御 (MAC) アドレスまたはシリアル番号を指定します。シリアル番号は、数字、文字、ハイフン、およびアンダースコアを使用して指定できます。たとえば、 -Identifier "AB37_679e" です。 MAC アドレスは 6 個以上の 2 文字のペアで指定する必要があります。このペアが単一の文字列値であるか、ハイフンまたはコロンを使用して区切られるかは、MAC アドレスによります (MAC アドレスには文字または数字、およびその両方を含めることができます)。次に示すものはいずれも有効な MAC アドレスです。 010203040506 01-02-03-04-05-06 01:02:03:04:05:06 01-02-03-04-05 のような MAC アドレスは、6 個以上の 2 文字のペアでないため、受け入れられません。 |
IdentifierType |
必須 |
文字列 |
テスト デバイスが MAC アドレスまたはシリアル番号で一意に識別されるかどうかを示します。デバイスを MAC アドレスで識別するには、IdentifierType を MACAddress に設定します。デバイスをシリアル番号で識別するには、IdentifierType を SerialNumber に設定します。設定できる値は、MACAddress と SerialNumber のみです。 |
Force |
省略可能 |
スイッチ パラメーター |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice オブジェクト。Set-CsTestDevice はテスト デバイス オブジェクトのパイプライン処理された入力を受け入れます。
戻り値の種類
Set-CsTestDevice を実行しても、値やオブジェクトが戻されることはありません。代わりに Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice オブジェクトのインスタンスを構成します。
例
-------------------------- 例 1 ------------------------
Set-CsTestDevice -Identity site:Redmond/UCPhone -Identifier "09768-ABDR-83295"
上記のコマンドを実行すると、Redmond サイトに割り当てられている UCPhone という名前のテスト デバイスの Identifier プロパティが変更されます。
-------------------------- 例 2 ------------------------
Set-CsTestDevice -Identity site:Redmond/UCPhone -IdentifierType SerialNumber -Identifier "09768-ABDR-83295"
例 2 のコマンドを実行すると、Redmond サイトに割り当てられている UCPhone という名前のテスト デバイスも変更されます。ただし、この場合、コマンドを実行すると、新しい識別子が指定されるだけでなく、次の新しい IdentifierType も指定されます。SerialNumber。