Compartilhar via


Get-CsDeviceUpdateRule

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as regras de atualização de dispositivos configuradas para uso na organização. As regras de atualização de dispositivos são usadas para associar atualizações de firmware com dispositivos que executam Microsoft Lync 2010 Phone Edition.

Sintaxe

Get-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsDeviceUpdateRule [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

Microsoft Lync Server 2010 usa regras de atualização de dispositivos como uma maneira de fornecer atualizações de firmware para dispositivos que executam Lync 2010 Phone Edition. Periodicamente, os administradores carregam para o Lync Server 2010 um conjunto de regras de atualização de dispositivos. Depois que essas regras tiverem sido testadas e aprovadas, elas serão automaticamente baixadas e aplicadas aos dispositivos relevantes, à medida que eles se conectarem ao sistema. Por padrão, os dispositivos verificam se há novas regras de atualização sempre que forem ligados e se conectarem ao Lync Server. Os dispositivos também verificam se há atualizações a cada 24 horas após o registro inicial.

As regras de atualização de dispositivos podem ser importadas (e aplicadas) ao serviço do Serviços Web. O cmdlet Get-CsDeviceUpdateRule permite retornar informações sobre as regras de atualização de dispositivos que tiverem sido importadas para uso na organização.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsDeviceUpdateRule localmente: RTCUniversalUserAdmins, 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 "Get-CsDeviceUpdateRule"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

Identificador exclusivo da regra de atualização de dispositivos. A identidade da regra de atualização de dispositivos é composta por duas partes: o escopo de serviço em que a regra foi aplicada (por exemplo: service:WebServer:atl-cs-001.litwareinc.com) e o GUID (identificador global exclusivo) pré-atribuído à regra (por exemplo: d5ce3c10-2588-420a-82ac-dc2d9b1222ff9). Com base nisso, a identidade de uma dada regra de atualização de dispositivo terá a seguinte aparência: "service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 ".

Curingas não podem ser usados para especificar uma Identity. Utilize o parâmetro Filter se desejar utilizar caracteres curinga ao especificar uma regra.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga ao se especificar a identidade de uma regra ou conjunto de regras de atualização de dispositivos. Por exemplo, para retornar todas as regras de atualização de dispositivos de WebServer:atl-cs-001.litwareinc.com, utilize esse valor de filtro: "service:WebServer:atl-cs-001.litwareinc.com*".

LocalStore

Opcional

Parâmetro de opção

Recupera os dados da regra de atualização de dispositivos na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsDeviceUpdateRule não aceita a entrada canalizada.

Tipos de Retorno

Get-CsDeviceUpdateRule retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule.

Exemplo

-------------------------- Exemplo 1 ------------------------

Get-CsDeviceUpdateRule

O comando anterior retorna informações sobre todas as regras de atualização de dispositivos que tiverem sido aplicadas na organização. O ato de chamar Get-CsDeviceUpdateRule sem quaisquer parâmetros adicionais sempre retornará a coleção completa de regras de atualização de dispositivos.

-------------------------- Exemplo 2 ------------------------

Get-CsDeviceUpdateRule -Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9

O comando apresentado no Exemplo 2 retorna informações sobre a regra de atualização de dispositivos cuja identidade for "WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

-------------------------- Exemplo 3 ------------------------

Get-CsDeviceUpdateRule -Filter service:WebServer:atl-cs-001.litwareinc.com*

O Exemplo 3 retorna informações sobre todas as regras de atualização de dispositivos configuradas para o serviço WebServer:atl-cs-001.litwareinc.com. Para realizar esta tarefa, utiliza-se o parâmetro Filter, juntamente com o valor de filtro "WebServer:atl-cs-001.litwareinc.com *". Esse filtro limita os dados retornados a regras de atualização de dispositivos cuja identidade começar com o valor da cadeia de caracteres "service:WebServer:atl-cs-001.litwareinc.com".

-------------------------- Exemplo 4 ------------------------

Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"}

O comando anterior retorna todas as regras de atualização de dispositivos cuja propriedade Brand for igual a "LG-Nortel". Para fazer isso, Get-CsDeviceUpdateRule é chamado, para retornar uma coleção de todas as regras de atualização de dispositivos na organização. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas as regras cuja propriedade Brand for igual a "LG-Nortel".

-------------------------- Exemplo 5 ------------------------

Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -eq $Null}

O Exemplo 5 retorna uma coleção de todas as regras de atualização de dispositivos que não tiverem sido aprovadas. Isto é feito utilizando-se Get-CsDeviceUpdateRules, para retornar uma coleção de todas as regras, e canalizando-se essa coleção para Where-Object. Por sua vez, Where-Object selecionará apenas as regras cuja propriedade Approved for igual a um valor null. Se a propriedade Approved for nula, essas regras não serão aprovadas.

-------------------------- Exemplo 6 ------------------------

Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -ne $Null -and $_.Brand -eq "LG-Nortel"}

O comando apresentado acima retorna uma coleção de todas as regras de atualização de dispositivos que atenderem a dois critérios: a regra foi aprovada e se relaciona aos dispositivos LG-Nortel. Para fazer isso, Get-CsDeviceUpdateRule é chamado, para retornar uma coleção de todas as regras de atualização de dispositivos na organização. Esta coleção será então canalizada para Where-Object, que filtrará a coleção segundo dois critérios: a propriedade Approved não deve ser nula (ou seja, esta propriedade deve ter algum tipo de valor) e Brand deve ser igual a "LG-Nortel".