Clear-CsDeviceUpdateLog
Tópico modificado em: 2012-03-23
Exclui todos os arquivos de auditoria e log do serviço Web de Atualização de Dispositivo que sejam mais antigos do que o número especificado de dias.
Sintaxe
Clear-CsDeviceUpdateLog -Identity <XdsIdentity> -DaysBack <Int32> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
O serviço Web de Atualização de Dispositivo mantém uma extensa coleção de arquivos de log; essa coleção inclui tantos os logs da auditoria conduzida pelo serviço em si quanto os arquivos de log carregados a partir de dispositivos cliente, como telefones celulares. Dependendo da quantidade de atividade de atualização de dispositivo, e do número de dispositivos cliente usados em sua organização, o servidor logo pode ficar “entupido” de logs do serviço Web de Atualização de Dispositivo. O cmdlet Clear-CsDeviceUpdateLog oferece uma maneira de reduzir a quantidade de arquivos de log armazenados no servidor: basta executar o cmdlet e especificar a idade máxima (em dias) dos arquivos que não devem ser removidos. Os arquivos de log mais antigos do que a idade máxima serão removidos do sistema.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Clear-CsDeviceUpdateLog 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 "Clear-CsDeviceUpdateLog"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Identidade Xds |
Identificador exclusivo do serviço que hospeda os arquivos do serviço Web de Atualização de Dispositivo. Por exemplo, esta sintaxe limpa os arquivos de log do serviço Web de Atualização de Dispositivo do Serviços Web para o pool atl-cs-001.litwareinc.com: -Identity "service:WebServer:atl-cs-001.litwareinc.com". |
DaysBack |
Obrigatório |
Inteiro |
Idade máxima (em dias) dos arquivos de log a serem mantidos. Todos os arquivos de log mais antigos do que o valor especificado usando o parâmetro DaysBack serão excluídos. Por exemplo, se DaysBack for definido como 7, todos os arquivos de log com mais de sete dias serão removidos. O parâmetro pode ser definido como qualquer número inteiro entre 1 e 30, inclusive. |
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
Nenhuma. Clear-CsDeviceUpdateLog não aceita entrada em pipeline.
Tipos de Retorno
Nenhuma. Clear-CsDeviceUpdateLog não retorna nenhum valor.
Exemplo
-------------------------- Exemplo 1 ------------------------
Clear-CsDeviceUpdateLog -Identity "service:WebServer:atl-cs-001.litwareinc.com" -DaysBack 10
O comando mostrado no Exemplo 1 conecta ao serviço Web de Atualização de Dispositivo com identidade "service:WebServer:atl-cs-001.litwareinc.com" e exclui todos os logs de auditoria e dispositivo que tenham mais de 10 dias de existência.