New-CsTestDevice
Tópico modificado em: 2012-03-26
Cria uma nova atualização do dispositivo para gerenciamento de dispositivo teste. Dispositivos de teste oferecem uma forma dos administradores testarem atualização de firmware antes que estas atualizações sejam distribuídas a todos os dispositivos na organização.
Sintaxe
New-CsTestDevice -Identity <XdsIdentity> -Identifier <String> -IdentifierType <MACAddress | SerialNumber> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
New-CsTestDevice -Identifier <String> -IdentifierType <MACAddress | SerialNumber> -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Identificando telefones específicos compatíveis com 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 nos 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.
Ao invés disso, estas regras pendentes vão ser 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 funcionarem, estes administradores podem então marcar as regras como aprovadas; as regras aprovadas são então baixadas e instaladas por todos os dispositivos relevantes na organização.
Dispositivos de teste são criados usando o cmdlet New-CsTestDevice. Estes dispositivos de teste podem ser configurados tanto no escopo global quanto no escopo do site.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-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 "New-CsTestDevice"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsIdentity |
Indica a Identity para o novo dispositivo de teste. Uma Identidade consiste tanto do escopo ao qual o dispositivo de teste vai ser atribuído (por exemplo, site:Redmond) quanto do nome para o novo dispositivo (por exemplo, UCPhone). Para atribuir um dispositivo de teste chamado UCPhone ao site Redmond, seu parâmetro Identity precisa ser parecido com: -Identity "site:Redmond/UCPhone". |
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, hifens 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 reunidos em 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 vai ser unicamente identificado pelo endereço MAC ou pelo seu número serial. 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. |
Name |
Opcional |
Cadeia de caracteres |
Nome para o novo dispositivo de teste (nomes devem ser únicos em um dado escopo). O parâmetro Name deve ser usado somente quando usando o parâmetro Parent. |
Parent |
Opcional |
Cadeia de caracteres |
Nome do escopo (por exemplo, site:Redmond), para o qual o novo dispositivo de teste vai ser atribuído. Se o parâmetro Parent for usado, será necessário usar o parâmetro Name, por exemplo: -Parent site:Redmond –Name UCPhone. Se o parâmetro Parent for usado, não use o parâmetro Identity, e vice-versa. |
Force |
Opcional |
Parâmetro de Opção |
Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando. |
InMemory |
Opcional |
Parâmetro de Opção |
Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet. |
WhatIf |
Opcional |
Parâmetro de Opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetro de Opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Nenhuma. New-CsTestDevice não aceita entrada em pipeline.
Tipos de Retorno
Cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Exemplo
-------------------------- Exemplo 1 ------------------------
New-CsTestDevice -Identity site:Redmond/UCPhone -IdentifierType SerialNumber -Identifier "07823-A345"
O comando anterior cria um novo dispositivo de teste (chamado UCPhone) para o site Redmond. Note a sintaxe usada para especificar a Identity do dispositivo: o escopo do dispositivo (site:Redmond) seguido do caracter / seguido pelo nome do dispositivo (UCPhone). O dispositivo usa o número serial como IdentifierType, e tem um número serial 07823-A345.
-------------------------- Exemplo 2 ------------------------
New-CsTestDevice -Parent Redmond -Name UCPhone -IdentifierType SerialNumber -Identifier "07823-A345"
O comando mostrado no Exemplo 2 é uma variação do comando mostrado no Exemplo 1. No Exemplo 2, no entanto, o parâmetro Identity não é usado. Em vez disso, o parâmetro Parent é usado para especificar o escopo para o novo dispositivo de teste (site:Redmond) e o parâmetro Name é usado para indicar o nome do novo dispositivo (UCPhone). O cmdlet New-CsTestDevice vai pegar estes dois valores de parâmetros e construir a Identidade do dispositivo de teste (site:Redmond/UCPhone) para você.