New-EventLog
Cria um novo log de eventos e uma nova fonte de eventos em um computador local ou remoto.
New-EventLog
[-LogName] <string>
[-Source] <string[]>
[[-ComputerName] <string[]>]
[-CategoryResourceFile <string>]
[-MessageResourceFile <string>]
[-ParameterResourceFile <string>]
[<CommonParameters>]
Este cmdlet cria um novo log de eventos clássico em um computador local ou remoto. Ele também pode registrar uma fonte de eventos que grava no novo log ou em um log existente.
Os cmdlets que contêm o EventLog
substantivo (os cmdlets do log de eventos) funcionam apenas em logs de eventos clássicos. Para obter eventos de logs que usam a tecnologia de Log de Eventos do Windows no Windows Vista e versões posteriores do Windows, use Get-WinEvent
.
Este comando cria o TestLog
log de eventos no computador local e registra uma nova fonte para ele.
New-EventLog -Source TestApp -LogName TestLog -MessageResourceFile C:\Test\TestApp.dll
Este comando adiciona uma nova fonte de eventos, NewTestApp
, ao log do aplicativo no computador remoto Server01.
$file = "C:\Program Files\TestApps\NewTestApp.dll"
New-EventLog -ComputerName Server01 -Source NewTestApp -LogName Application -MessageResourceFile $file -CategoryResourceFile $file
O comando requer que o NewTestApp.dll
arquivo esteja localizado no computador Server01.
Especifica o caminho para o arquivo que contém cadeias de caracteres de categoria para os eventos de origem. Este arquivo também é conhecido como o arquivo de mensagem de categoria.
O arquivo deve estar presente no computador no qual o log de eventos está sendo criado. Este parâmetro não cria nem move ficheiros.
Tipo: | String |
Aliases: | CRF |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Cria os novos logs de eventos nos computadores especificados. A predefinição é o computador local.
O nome NetBIOS, endereço IP ou nome de domínio totalmente qualificado de um computador remoto. Para especificar o computador local, digite o nome do computador, um ponto (.
) ou localhost
.
Esse parâmetro não depende da comunicação remota do PowerShell. Você pode usar o parâmetro ComputerName mesmo Get-EventLog
se o computador não estiver configurado para executar comandos remotos.
Tipo: | String[] |
Aliases: | CN |
Position: | 3 |
Default value: | Local computer |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica o nome do log de eventos.
Se o log não existir, New-EventLog
criará o log e usará esse valor para as propriedades Log e LogDisplayName do novo log de eventos. Se o log existir, New-EventLog
registrará uma nova fonte para o log de eventos.
Tipo: | String |
Aliases: | LN |
Position: | 1 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica o caminho para o arquivo que contém cadeias de caracteres de formatação de mensagem para os eventos de origem. Esse arquivo também é conhecido como Arquivo de Mensagem de Evento.
O arquivo deve estar presente no computador no qual o log de eventos está sendo criado. Este parâmetro não cria nem move ficheiros.
Tipo: | String |
Aliases: | MRF |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica o caminho para o arquivo que contém cadeias de caracteres usadas para substituições de parâmetros em descrições de eventos. Esse arquivo também é conhecido como arquivo de mensagem de parâmetro.
O arquivo deve estar presente no computador no qual o log de eventos está sendo criado. Este parâmetro não cria nem move ficheiros.
Tipo: | String |
Aliases: | PRF |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Especifica os nomes das fontes do log de eventos, como programas de aplicativos que gravam no log de eventos. Este parâmetro é obrigatório.
Tipo: | String[] |
Aliases: | SRC |
Position: | 2 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
None
Não é possível canalizar a entrada para este cmdlet.
Para usar New-EventLog
no Windows Vista e em versões posteriores do Windows, abra o PowerShell com a opção Executar como administrador .
Para criar uma fonte de eventos no Windows Vista, Windows XP Professional ou Windows Server 2003, você deve ser membro do grupo Administradores no computador.
Quando você cria um novo log de eventos e uma nova fonte de eventos, o sistema registra a nova fonte para o novo log, mas o log não é criado até que a primeira entrada seja gravada nele.
O sistema operacional armazena logs de eventos como arquivos.
Quando você cria um novo log de eventos, o arquivo associado é armazenado no $env:SystemRoot\System32\Config
diretório no computador especificado.
O nome do arquivo são os primeiros oito caracteres da propriedade Log com uma .evt
extensão de nome de arquivo.
Comentários do PowerShell
O PowerShell é um projeto código aberto. Selecione um link para fornecer comentários: