Set-CsTestDevice
Tópico modificado em: 2012-03-25
Modifica um ou mais dos dispositivos de teste de gerenciamento da atualização do dispositivo configurados para serem usados na organização. Os dispositivos de teste oferecem aos administradores uma forma de testar atualizações de firmware antes dessas atualizações serem distribuídas para todos os dispositivos de uma organização.
Sintaxe
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>]]
Descrição Detalhada
Identificando telefones específicos executando o Microsoft Lync 2010 Phone Edition ou outros dispositivos como dispositivos de teste, os administradores podem verificar e aprovar atualizações de firmware antes dessas atualizações serem implantadas em todos os dispositivos relevantes da organização. Quando as regras de atualização do dispositivo forem importadas para o Microsoft Lync Server 2010, elas serão marcadas como "pendentes"; isso significa que as atualizações correspondentes a essas regras não serão baixadas e instaladas automaticamente pelos dispositivos afetados.
Em vez disso, essas regras pendentes serão baixadas e instaladas por qualquer dispositivo de teste relevante. Esta é a ideia por trás dos dispositivos de teste: novas regras de atualização do dispositivo são aplicadas automaticamente a dispositivos de teste, o que dá aos administradores a oportunidade de verificar se as atualizações de firmware funcionam conforme o esperado. Se elas funcionarem, esses administradores poderão marcar as regras como aprovadas; em seguida, as regras aprovadas são baixadas e instaladas por todos os dispositivos relevantes da organização.
Dispositivos de teste são criados usando o cmdlet New-CsTestDevice. Depois que um dispositivo de teste for criado, será possível usar o cmdlet Set-CsTestDevice para alterar os parâmetros Identifier e/ou IdentifierType desse dispositivo ou de qualquer outro dispositivo de teste.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsTestDevice localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsTestDevice"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
Xds Identity |
Indica a Identity do dispositivo de teste a ser modificada. Por exemplo: -Identity site:Redmond/UCPhoneTestDevice. Observe não ser possível usar curingas durante a especificação de uma Identity. |
Instance |
Opcional |
Objeto do dispositivo de teste |
Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais. |
Identifier |
Obrigatório |
Cadeia de caracteres |
Com base no parâmetro IdentifierType, indica o endereço MAC ou número de série do novo dispositivo de teste. Números seriais podem ser especificados com números, letras, hífens e sublinhados; por exemplo: -Identifier "AB37_679e" Endereços MAC devem ser especificados com seis ou mais pares de dois caracteres; dependendo do endereço MAC, esses pares podem ser uma única cadeia de caracteres ou ser separados por hifens e dois-pontos (observe que os endereços MAC podem incluir letras e/ou números). Os endereços MAC a seguir são endereços válidos: 010203040506 01-02-03-04-05-06 01:02:03:04:05:06 Um endereço MAC 01-02-03-04-05 não será aceito, por não possuir um mínimo de seis pares de dois caracteres. |
IdentifierType |
Obrigatório |
Cadeia de caracteres |
Indica se o dispositivo de teste será identificado com exclusividade pelo endereço MAC ou pelo número de série. Para identificar um dispositivo pelo endereço MAC, defina IdentifierType como MACAddress. Para identificar um dispositivo pelo número de série, defina IdentifierType como SerialNumber. MACAddress e SerialNumber são os únicos valores permitidos. |
Force |
Opcional |
Parâmetros de opção |
Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando. |
WhatIf |
Opcional |
Parâmetros de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetros de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice. Set-CsTestDevice aceita entrada em pipeline do objeto de dispositivo de teste.
Tipos de Retorno
Set-CsTestDevice não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsTestDevice -Identity site:Redmond/UCPhone -Identifier "09768-ABDR-83295"
O comando anterior modifica a propriedade Identifier do dispositivo de teste chamado UCPhone atribuído ao site Redmond.
-------------------------- Exemplo 2 ------------------------
Set-CsTestDevice -Identity site:Redmond/UCPhone -IdentifierType SerialNumber -Identifier "09768-ABDR-83295"
O comando mostrado no Exemplo 2 também modifica um dispositivo de teste chamado UCPhone atribuído ao site Redmond. Nesse caso, no entanto, o comando não apenas especifica um novo Identificador, como também atribui um novo IdentifierType: SerialNumber.