Compartilhar via

  • Artigo

Remove-CsDeviceUpdateRule

 

Tópico modificado em: 2012-03-25

Remove uma regra de atualização de dispositivo configurada para uso em sua organização. Regras de atualização de dispositivos são usadas para associar atualizações de firmware a dispositivos que executem o Microsoft Lync 2010 Phone Edition.

Sintaxe

Remove-CsDeviceUpdateRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Microsoft Lync Server 2010 usa regras de atualização de dispositivo como uma forma de fornecer atualizações de firmware para dispositivos que executem o Lync 2010 Phone Edition. Periodicamente, os administradores carregam um conjunto de regras de atualização de dispositivo para o Lync Server 2010; depois de serem testadas e aprovadas, essas regras são baixadas e aplicadas automaticamente aos dispositivos apropriados assim que se conectam ao sistema. Por padrão, os dispositivos buscam novas regras de atualização sempre que são ligados e se conectam ao Lync Server. Os dispositivos também buscam atualizações a cada 24 horas, depois da autenticação inicial.

Os administradores não podem criar suas próprias regras de atualização de dispositivos; elas só podem ser criadas por meio do download e da importação de conjuntos de regras do site da Microsoft. Com o tempo, é provável que você colecione regras ultrapassadas e inúteis em sua organização. Por exemplo, se sua organização não utilizar mais telefones LG-Nortel, as atualizações de firmware desses dispositivos não serão necessárias. Embora essas regras desnecessárias não criem problemas, elas poderão complicar a administração: executar o cmdlet Get-CsDeviceUpdateRule para retornar uma coleção de todas as suas regras de dispositivos poderá criar confusão, se muitas dessas regras não se aplicarem à sua organização. Para ajudar a diminuir a confusão, Remove-CsDeviceUpdateRule pode ser usado para remover regras de atualização de dispositivos (ou um conjunto de regras) que tenham sido importadas para uso.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsDeviceUpdateRule 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 "Remove-CsDeviceUpdateRule"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

Identificador único para a regra de atualização de dispositivo. A identidade de uma regra de atualização de dispositivo é composta por duas partes: O escopo de serviço no qual 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 regra de atualização de dispositivo específica se parecerá com: "service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

Curingas não podem ser usados para especificar uma Identity.

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.DeviceUpdate.Rule. Remove-CsDeviceUpdateRule aceita instâncias em pipeline do objeto de regra de atualização de dispositivo.

Tipos de Retorno

Remove-CsDeviceUpdateRule não retorna um valor ou objeto. Em vez disso, o cmdlet exclui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.Rule.

Exemplo

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

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

O comando anterior exclui a regra de atualização de dispositivo com a identidade service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9. Depois que a regra for excluída, a atualização de firmware correspondente não estará mais disponível para uso.

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

Get-CsDeviceUpdateRule | Remove-CsDeviceUpdateRule

O comando mostrado no Exemplo 2 remove todas as regras de atualização de dispositivos que tenham sido configuradas para uso na organização. Para fazer isso, o cmdlet Get-CsDeviceUpdateRule é chamado (sem parâmetros) para retornar uma coleção de todas as regras de atualização de dispositivos em uso no momento. Essa coleção é então canalizada para Remove-CsDeviceUpdateRule, que exclui todas as regras da coleção.

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

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

No Exemplo 3, todas as regras de atualização de dispositivos que tenham sido importadas para o serviço WebServer:atl-cs-001.litwareinc.com são removidas. Para fazer isso, o comando usa primeiro Get-CsDeviceUpdateRule e o parâmetro Filter para recuperar todas as regras de atualização de dispositivos que tenham Identidade começando por "service:WebServer:atl-cs-001.litwareinc.com". Essa coleção é então canalizada para Remove-CsDeviceUpdateRule, que exclui todas as regras da coleção.

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

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

O comando anterior exclui todas as regras de atualização de dispositivos com Brand igual a "LG-Nortel". Para fazer isso, o cmdlet chama Get-CsDeviceUpdateRule sem parâmetros para recuperar uma coleção de todas as regras de atualização de dispositivos em uso na organização. Esta coleção é então canalizada para o cmdlet Where-Object, que seleciona apenas as regras nas quais Brand seja igual a "LG-Nortel". A coleção filtrada é então canalizada para Remove-CsDeviceUpdateRule, que remove todas as regras da coleção.