Logotipo do PowerShell

O PowerShell é usado por muitos administradores de servidor. Naturalmente, uma das tarefas mais usadas é a capacidade de criar scripts e funções para inventariar seus servidores e entender o que seu ambiente possui.

Embora existam muitas maneiras de fazer isso, com níveis variados de complexidade, criaremos um Relatório de Inventário do Windows Server bastante simples, porém eficaz, neste artigo.

Pré-requisitos

Este artigo será prático. Se você pretende acompanhar, verifique se possui os seguintes pré-requisitos:

  • Trabalhando em um PC Windows 10 ingressado no domínio do Active Directory (AD)
  • Tenha o módulo ActiveDirectory PowerShell instalado a partir do Kit de ferramentas RSAT.
  • Ter permissão para consultar contas de computador AD
  • Pode executar consultas remotas WMI / CIM em computadores remotos
  • Ter Comunicação remota do PowerShell disponível em computadores remotos

Recuperando Servidores

Os fundamentos do script que estamos construindo são os próprios servidores. Você pode escrevê-los individualmente em um arquivo de texto que é lido ou em uma matriz dentro do próprio script, mas usando o PowerShell, podemos fazer um melhor. Para tornar o script mais dinâmico e não exigir que seja modificado sempre que um novo servidor for adicionado, podemos usar o Active Directory (AD) para extrair a lista de objetos de computador em uma determinada unidade organizacional (OU).

Abaixo, estamos utilizando o ActiveDirectory módulo, disponível no Kit de ferramentas RSAT, para consultar o Servidores UO e recuperar todos os objetos de computador lá via Get-ADComputer.

Módulo de importação ActiveDirectory $ OU = 'OU = Servidores, DC = domínio, DC = local' $ Params = @ {     "SearchBase" = $ OU     "Filtro" = '*' } $ Servidores = Get-ADComputer @Params

Nesse ponto, poderíamos ter filtrado apenas a propriedade name para preencher o $ servidores variável, mas geralmente é muito útil ter o objeto retornado inteiro para utilizar posteriormente.

Determinando os dados a serem coletados

Agora que temos nossos servidores, precisamos descobrir o que exatamente devemos coletar de cada servidor. Um motivo pelo qual pode ser importante manter o objeto AD completo é combinar esses dados com os dados diretamente do próprio servidor para obter uma imagem maior do seu ambiente.

Na prática, como é que algo assim se parece? Vamos listar algumas das propriedades que seria muito útil conhecer.

Valores do servidor

  • Nome do host do servidor
  • Espaço livre em disco
  • Memória
  • Conexões de rede

Valores AD

  • Último conjunto de senhas
  • Último logon
  • Nome de host DNS

Recuperando informações do servidor

Como coletamos essas informações em nossa lista de servidores retornados? Como temos uma lista de servidores, teremos que repetir o processo $ Servidores objeto e consulta. Começando com um simples Foreach-Object loop abaixo, podemos criar um objeto personalizado para armazenar nossos valores.

$ Servidores | Objeto Foreach {     (PSCustomObject) @ {         "ServerHostName" = $ _. Nome         "Descrição" = $ _. Descrição         "FreeDiskSpace" = $ Nulo         "TotalMemory" = $ Nulo         "NetworkConnections" = $ Nulo         "PasswordLastSet" = $ _. PwdLastSet         "LastLogon" = $ _. LastLogon         "DNSHostName" = $ _. DNSHostName         "CreationDate" = $ _. WhenCreated     } }

Como você pode ver, ao salvar o objeto completo do Active Directory quando recuperamos os computadores pela primeira vez, vamos preencher uma ampla variedade de informações. Infelizmente, essa não é toda a informação que precisamos.

Para obter as informações de cada servidor, utilizaremos uma interface familiar para muitos administradores de servidor, que é a interface WMI (Windows Management Instrumentation). Você pode observar que os cmdlets usados ​​abaixo são da interface Common Information Model (CIM), da qual o WMI é a implementação deste padrão pela Microsoft.

Obtenha espaço livre em disco

Usando a classe WMI disponível de Win32_LogicalDisk, podemos obter todos os discos disponíveis e seu espaço livre. Quando executamos o comando pela primeira vez, Get-CimInstance -ClassName Win32_LogicalDisk, você pode perceber que não é exatamente legível na saída padrão.

O segundo problema aqui é que temos mais de uma unidade sendo devolvida. Gostaria de saber sobre cada uma dessas unidades e quanto espaço livre está disponível em GBs. Vamos modificar o código para fazer algumas transformações e torná-lo melhor.

$ Disks = Get-CimInstance -ClassName Win32_LogicalDisk $ DisksResult = $ Discos | Objeto Foreach {     (PSCustomObject) @ {         "Drive" = $ _. DeviceID         "FreeSpace" = (Math) :: Round (($ _. FreeSpace / 1GB), 2)     } } $ DisksResult

Depois de executar os comandos, nossa saída é muito mais limpa e agora pode ser usada em nosso script.

Mas e se quiséssemos alertar sobre uma condição de pouco espaço em disco? Seria bom expandir isso levemente para definir um sinalizador em cada unidade que atenda a essa condição. Comparando o espaço livre com o espaço total disponível, podemos ver se ele tem menos de 10% ou 10 GB. A razão para o -ou condição, é que, em discos muito grandes, 10% ainda podem ser muito generosos, portanto, a definição de um limite absoluto ajuda.

$ Disks = Get-CimInstance -ClassName Win32_LogicalDisk $ DisksResult = $ Discos | Objeto Foreach {   $ FreeSpace = (Math) :: Round (($ _. FreeSpace / 1GB), 2)   $ TotalSpace = (Math) :: Round (($ _. Size / 1GB), 2)   If (($ FreeSpace / $ TotalSpace -LT 0.10) -ou $ FreeSpace -LT 10) {     $ LowDiskSpace = $ True   } Outro {     $ LowDiskSpace = $ False   }     (PSCustomObject) @ {         "Drive" = $ _. DeviceID     "FreeSpace" = $ FreeSpace     "LowDiskSpace" = $ LowDiskSpace     } } $ DisksResult

Como você pode ver agora, temos um ótimo conjunto de informações a serem salvas com nossos servidores.

Como% 20to% 20Build% 20a% 20Windows% 20Server% 20Inventory% 20Report% 20for / Untitled% 202.png

Obtenha a memória disponível

É útil saber quanta RAM é alocada para cada servidor, especialmente em um ambiente de máquina virtual. Se você achar que alguns são provisionados em excesso, poderá economizar recursos valiosos dimensionando corretamente os servidores. Felizmente, isso é muito mais simples de recuperar.

Usando o Win32_PhysicalMemory Classe WMI, podemos somar todos os retornados Capacidade propriedades para obter a memória total.

(Get-CimInstance -ClassName Win32_PhysicalMemory | Measure-Object -Property Capacity -Sum) .Sum / 1GB

Obtenha todas as conexões de rede

Finalmente, queremos recuperar todas as conexões de rede juntas. Isso é útil para saber se um determinado servidor tem várias interfaces com as quais se preocupar. Usando um mecanismo ligeiramente diferente desta vez, estamos usando o Get-NetAdapter cmdlet, mas como esse não possui um Nome do computador No parâmetro, usaremos o PS Remoting para chamar isso localmente no servidor de destino e retornar os resultados ao nosso script.

$ NetworkConnections = Invoke-Command -ComputerName $ _. DnsHostName -ScriptBlock {     Get-NetAdapter - Físico | Nome do objeto de seleção, Status, Velocidade da ligação }

Nossa saída será semelhante à abaixo e podemos salvar isso em nosso script.

Lembre-se de que, para Comando de chamada Para funcionar, o PS Remoting precisará ser configurado nos servidores de destino.

Juntando tudo

Agora que temos todas as peças, vamos juntar tudo isso. O script final está abaixo e combina todo o código para criar um objeto de saída personalizado com exatamente o que queremos reportar.

Módulo de importação ActiveDirectory $ OU = 'OU = Servidores, DC = domínio, DC = local' $ Params = @ {     "SearchBase" = $ OU     "Filtro" = '*' } $ Servidores = Get-ADComputer @Params $ Servidores | Objeto Foreach {   $ Disks = Get-CimInstance -ComputerName $ _. DnsHostName -ClassName Win32_LogicalDisk   $ DisksResult = $ Discos | Objeto Foreach {     (PSCustomObject) @ {       "Drive" = $ _. DeviceID       "FreeSpace" = (Math) :: Round (($ _. FreeSpace / 1GB), 2)     }   }      $ NetworkConnections = Invoke-Command -ComputerName $ _. DnsHostName -ScriptBlock {     Get-NetAdapter - Físico | Nome do objeto de seleção, Status, Velocidade da ligação   }     (PSCustomObject) @ {         "ServerHostName" = $ _. Nome         "Descrição" = $ _. Descrição         "FreeDiskSpace" = $ DisksResult         "TotalMemory" = ((Get-CimInstance -ComputerName $ _. DnsHostName -ClassName Win32_PhysicalMemory | Measure-Object -Property Capacity -Sum) .Sum / 1GB)         "NetworkConnections" = $ NetworkConnections         "PasswordLastSet" = $ _. PwdLastSet         "LastLogon" = $ _. LastLogon         "DNSHostName" = $ _. DNSHostName         "CreationDate" = $ _. WhenCreated     } }

Conclusão

O que demonstramos aqui é apenas a ponta do iceberg em termos do que pode ser construído para um relatório de inventário. Existem muitas propriedades mais úteis que você pode adicionar a este relatório. Levando isso adiante, você pode criar isso em uma página HTML, agendar uma tarefa para ser executada semanalmente ou até envolvê-la em outras ferramentas, como o Ansible.

O PowerShell facilita trivialmente a obtenção de todas as informações necessárias em um único local. Depois de analisar seu ambiente e determinar o que você precisa saber, crie o relatório no PowerShell para ajudar a comprovar sua capacidade de auditar seu ambiente.

Adicione ao Google Notícias