functions/Get-DbaPageFileSetting.ps1
|
#ValidationTags#Messaging,FlowControl,Pipeline,CodeStyle# function Get-DbaPageFileSetting { <# .SYNOPSIS Returns information on the pagefile configuration of the target computer. .DESCRIPTION This command uses CIM (or other, related computer management tools) to detect the pagefile configuration of the target compuer(s). Note that this may require local administrator privileges for the relevant computers. .PARAMETER ComputerName The Server that you're connecting to. This can be the name of a computer, a SMO object, an IP address, an AD COmputer object, a connection string or a SQL Instance. .PARAMETER Credential Credential object used to connect to the Computer as a different user .PARAMETER EnableException By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message. This avoids overwhelming you with "sea of red" exceptions, but is inconvenient because it basically disables advanced scripting. Using this switch turns this "nice by default" feature off and enables you to catch exceptions with your own try/catch. .NOTES Tags: CIM Author: Klaas Vandenberghe ( @PowerDBAKlaas ) dbatools PowerShell module (https://dbatools.io) Copyright (C) 2016 Chrissy LeMaire License: MIT https://opensource.org/licenses/MIT .EXAMPLE Get-DbaPageFileSetting -ComputerName ServerA,ServerB Returns a custom object displaying ComputerName, AutoPageFile, FileName, Status, LastModified, LastAccessed, AllocatedBaseSize, InitialSize, MaximumSize, PeakUsage, CurrentUsage for ServerA and ServerB .EXAMPLE 'ServerA' | Get-DbaPageFileSetting Returns a custom object displaying ComputerName, AutoPageFile, FileName, Status, LastModified, LastAccessed, AllocatedBaseSize, InitialSize, MaximumSize, PeakUsage, CurrentUsage for ServerA .LINK https://dbatools.io/Get-DbaPageFileSetting #> [CmdletBinding()] param ( [Parameter(Position = 0, ValueFromPipeline, ValueFromPipelineByPropertyName = $true)] [Alias("cn", "host", "ServerInstance", "Server", "SqlServer")] [DbaInstance]$ComputerName = $env:COMPUTERNAME, [PSCredential]$Credential, [Alias('Silent')] [switch]$EnableException ) process { foreach ($computer in $ComputerName) { Write-Message -Level VeryVerbose -Message "Connecting to $($computer.ComputerName)" -Target $computer $splatDbaCmObject = @{ ComputerName = $computer EnableException = $true } if ($Credential) { $splatDbaCmObject["Credential"] = $Credential } try { $compSys = Get-DbaCmObject @splatDbaCmObject -Query "SELECT * FROM win32_computersystem" if (-not $CompSys.automaticmanagedpagefile) { $pagefiles = Get-DbaCmObject @splatDbaCmObject -Query "SELECT * FROM win32_pagefile" $pagefileUsages = Get-DbaCmObject @splatDbaCmObject -Query "SELECT * FROM win32_pagefileUsage" $pagefileSettings = Get-DbaCmObject @splatDbaCmObject -Query "SELECT * FROM win32_pagefileSetting" } } catch { Stop-Function -Message "Failed to retrieve information from $($computer.ComputerName)" -ErrorRecord $_ -Target $computer -Continue } if (-not $CompSys.automaticmanagedpagefile) { foreach ($file in $pagefiles) { $settings = $pagefileSettings | Where-Object Name -EQ $file.Name $usage = $pagefileUsages | Where-Object Name -EQ $file.Name # pagefile is not automatic managed, so return settings New-Object Sqlcollaborative.Dbatools.Computer.PageFileSetting -Property @{ ComputerName = $computer.ComputerName AutoPageFile = $CompSys.automaticmanagedpagefile FileName = $file.name Status = $file.status SystemManaged = ($settings.InitialSize -eq 0) -and ($settings.MaximumSize -eq 0) LastModified = $file.LastModified LastAccessed = $file.LastAccessed AllocatedBaseSize = $usage.AllocatedBaseSize # in MB, between Initial and Maximum Size InitialSize = $settings.InitialSize # in MB MaximumSize = $settings.MaximumSize # in MB PeakUsage = $usage.peakusage # in MB CurrentUsage = $usage.currentusage # in MB } } } else { # pagefile is automatic managed, so there are no settings New-Object Sqlcollaborative.Dbatools.Computer.PageFileSetting -Property @{ ComputerName = $computer AutoPageFile = $CompSys.automaticmanagedpagefile FileName = $null Status = $null SystemManaged = $null LastModified = $null LastAccessed = $null AllocatedBaseSize = $null InitialSize = $null MaximumSize = $null PeakUsage = $null CurrentUsage = $null } } } } } |