Remove-CsTestDevice
Tópico modificado em: 2012-03-27
Remove o dispositivo de testes especificado para gerenciamento de atualização do dispositivo. Os dispositivos de teste fornecem aos administradores uma maneria de testar as atualizações de firmware antes que elas sejam distribuídas a todos os dispositivos na organização.
Sintaxe
Remove-CsTestDevice -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Ao identificar como dispositivos de teste determinados telefones compatíveis com o Microsoft Lync 2010 Phone Edition ou outros dispositivos, os administradores podem verificar e aprovar atualizações de firmware antes que elas sejam distribuídas a todos os dispositivos na organização. Quando as regras de atualização de dispositivos forem importadas para Microsoft Lync Server 2010, elas estarão marcadas como "pendentes", indicando que as atualizações correspondentes a essas regras não serão automaticamente baixadas e instaladas pelos dispositivos em questão.
Em vez disso, essas regras pendentes serão baixadas e instaladas por quaisquer dispositivos de teste relevantes. Esta é a ideia por trás dos dispositivos de teste: as regras de atualização de novos dispositivos são automaticamente aplicadas a dispositivos de teste, dando aos administradores a oportunidade de verificar se as atualizações de firmware funcionam conforme o esperado. Se funcionarem, os administradores poderão marcam as regras como aprovadas; as regras aprovadas são então baixadas e instaladas por todos os dispositivos relevantes na organização.
Os dispositivos de teste são dispositivos de hardware que executam o Lync 2010 Phone Edition. Esses dispositivos são criados usando-se o cmdlet New-CsTestDevice. Uma vez criados, os dispositivos podem ser removidos posteriormente, executando-se o cmdlet Remove-CsTestDevice. Observe que a remoção do dispositivo como um dispositivo de teste não o afetará. Por exemplo: o telefone compatível com o Lync 2010 Phone Edition pode continuar a ser utilizado para acessar o Lync Server 2010. A única diferença é que, como o dispositivo não é mais um dispositivo de teste, não efetuará mais downloads de regras de atualização dos dispositivos que estiverem no estado pendente. Em vez disso, o dispositivo esperará até que as regras tenham sido aprovadas, para poder baixá-las e instalá-las.
Remove-CsTestDevice pode ser utilizado para remover determinados dispositivos de teste que tiverem sido configurados no escopo global ou de site. É possível utilizar também o cmdlet para remover todos os dispositivos de teste configurados em um dado escopo.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsTestDevice localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTestDevice"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsIdentity |
Indica a Identidade do dispositivo de teste a ser removido. Para remover um dispositivo específico, inclua o escopo (por exemplo, site:Redmond) e o nome do dispositivo. Por exemplo: -Identity "site:Redmond/UCPhoneTest". Para remover todos os dispositivos de um determinado site, utilize uma sintaxe similar a: -Identity "site:Redmond". Os dispositivos de teste também podem ser removidos do escopo global. A coleção de dispositivos de teste global não pode ser removida. No entanto, o seguinte comando excluirá todos os dispositivos armazenados na coleção global: Remove-CsTestDevice –Identity global |
Force |
Opcional |
Parâmetro de opção |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando. |
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
Objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice. Remove-CsTestDevice aceita a entrada canalizada do objeto de dispositivo de teste.
Tipos de Retorno
Remove-CsTestDevice não retorna um valor ou objeto. Em vez disso, o cmdlet exclui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Exemplo
-------------------------- Exemplo 1 ------------------------
Remove-CsTestDevice -Identity site:Redmond
O comando anterior remove todos os dispositivos de teste do site de Redmond. Isto removerá a coleção de dispositivos, bem como os dispositivos de teste individuais.
-------------------------- Exemplo 2 ------------------------
Get-CsTestDevice | Remove-CsTestDevice
O comando apresentado no Exemplo 2 remove todos os dispositivos de teste configurados para uso na organização. Isto é feito utilizando-se Get-CsTestDevice, para retornar todas as coleções de dispositivos de teste e canalizando-se todos os itens para Remove-CsTestDevice. Observe que a coleção global de dispositivos de teste não pode ser removida; entretanto, este comando excluirá todos os dispositivos de teste configurados no nível global.
-------------------------- Exemplo 3 ------------------------
Get-CsTestDevice -Filter "site:" | Remove-CsTestDevice
No Exemplo 3, todos os dispositivos de teste configurados no escopo de site serão removidos. Para realizar essa tarefa, Get-CsTestDevice e o parâmetro Filter são utilizados para retornar todos os dispositivos de teste cuja identidade for iniciada pelo valor da cadeia de caracteres "site:". Esta coleção filtrada será então canalizada para Remove-CsTestDevice, que excluirá todos os itens da coleção.
-------------------------- Exemplo 4 ------------------------
Get-CsTestDevice | Where-Object {$_.Name -match "LG-Nortel Phone"} | Remove-CsTestDevice
O comando apresentado no Exemplo 4 exclui todos os dispositivos de teste de telefone LG-Nortel. Para fazer isso, o comando chama primeiramente Get-CsTestDevice, para retornar todos os dispositivos de teste configurados para uso na organização. Esta informação será então canalizada para o cmdlet Where-Object, que utilizará o operador -match para retornar dispositivos que tiverem o valor da cadeia de caracteres "LG-Nortel" em qualquer posição da propriedade Name. Qualquer dispositivo de teste que atender a esse critério será excluído, utilizando-se Remove-CsTestDevice.