Get-CsTestDevice
Tópico modificado em: 2012-03-23
Recupera a informação sobre dispositivos de teste de gerenciamento da atualização de dispositivo que foram configurados para uso em sua organização. 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
Get-CsTestDevice [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsTestDevice [-Filter <String>] [-LocalStore <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 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.
Ao invés disso, estas regras pendentes vão ser baixadas e instaladas por qualquer dispositivo de teste relevante. É para isso que servem os 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 podem ser atribuídos tanto ao escopo global quanto do site. Use o cmdlet Get-CsTestDevice para recuperar informações sobre os dispositivos de teste atualmente configurados para uso em sua organização.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsTestDevice localmente: RTCUniversalUserAdmins, 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 "Get-CsTestDevice"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
Xds Identity |
Indica a Identity do dispositivo de teste a ser retornado. Para se referir a um único dispositivo chamado UCPhone (armazenado na coleção global), use esta sintaxe: -Identity global/UCPhone. Para referir-se a um dispositivo encontrado em uma coleção de site, use sintaxe semelhante a esta: -Identity site:Redmond/UCPhone. Para referir-se a uma coleção inteira, deixe de fora o nome do dispositivo. Por exemplo, esta sintaxe retorna todos os dispositivos de teste configurados para o site Redmond: -Identity site:Redmond. Note que você não pode usar curingas quando especificando uma Identity. |
Filter |
Opcional |
Cadeia de caracteres |
Oferece uma forma de você usar caracteres curinga quando especificando o dispositivo de teste (ou dispositivos) a ser retornado. Por exemplo, para retornar todas as coleções de dispositivo de teste configurados no escopo do site, use esta sintaxe: -Filter "site:*". Para retornar todos os dispositivos que tenham o termo "EMEA" na sua Identity, use esta sintaxe: -Filter "*EMEA*". Observe que Filter atua somente na Identity da coleção de dispositivos de teste; você não pode filtrar em outras propriedades da coleção. |
LocalStore |
Opcional |
Parâmetro de Opção |
Obtém os dados de dispositivos de teste a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si. |
Tipos de Entrada
Nenhuma. Get-CsTestDevice não aceita entrada em pipeline.
Tipos de Retorno
Get-CsTestDevice retorna uma ou mais instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsTestDevice
Exemplo 1 retorna todos os dispositivos de teste na organização. Chamar Get-CsTestDevice sem nenhum parâmetro adicional vai retornar todos os dispositivos de teste atualmente em uso.
-------------------------- Exemplo 2 ------------------------
Get-CsTestDevice -Identity site:Redmond/UCPhone
O exemplo anterior retorna o dispositivo de teste chamado UCPhone que foi atribuído ao site Redmond.
-------------------------- Exemplo 3 ------------------------
Get-CsTestDevice -Identity site:Redmond
No exemplo 3, este comando retorna todos os dispositivos de teste configurados para o site Redmond.
-------------------------- Exemplo 4 ------------------------
Get-CsTestDevice -Filter site:*
O comando anterior retorna todos os dispositivos de teste que foram configurados no escopo do site. Para fazer isto, o comando usa o parâmetro Filter; o valor do filtro "site:*" limita os dados retornados aos dispositivos de teste que contenham uma Identity começando com a cadeia de caracteres "site:".