2019-11-01 08:20:21 +00:00
|
|
|
function Get-PSFirewallLogPath {
|
2020-01-06 15:07:44 +00:00
|
|
|
<#
|
|
|
|
.SYNOPSIS
|
|
|
|
|
|
|
|
Retrieves Windows Firewall log path for a given Profile.
|
|
|
|
|
|
|
|
.DESCRIPTION
|
|
|
|
|
|
|
|
Retrieves Windows Firewall log path for a local or remote machine for given Profile.
|
|
|
|
|
|
|
|
.EXAMPLE
|
|
|
|
|
|
|
|
Get-PSFirewallLogPath -LogProfile Domain
|
|
|
|
|
|
|
|
Retrieves path of the specified profile's log from the local machine.
|
|
|
|
|
|
|
|
.EXAMPLE
|
|
|
|
|
|
|
|
Get-PSFirewallLogPath -LogProfile Private -ComputerName MyRemoteComputer
|
|
|
|
|
|
|
|
Retrieves path of the specified profile's log from a remote machine using the Remote Regsitry service.
|
|
|
|
|
|
|
|
.EXAMPLE
|
|
|
|
|
|
|
|
Get-PSFirewallLogPath -LogProfile Domain -ComputerName MyRemoteComputer -InferPath
|
|
|
|
|
|
|
|
Retrieves path of the specified profile's log from a remote machine using registry settings configured on the local machine.
|
|
|
|
|
|
|
|
#>
|
|
|
|
|
2019-11-01 08:20:21 +00:00
|
|
|
param(
|
|
|
|
# Log Profile to retrieve path for
|
|
|
|
[Parameter(Mandatory = $true)]
|
|
|
|
[ValidateSet('Public','Private','Domain')]
|
|
|
|
[string]
|
|
|
|
$LogProfile,
|
|
|
|
|
|
|
|
# Remote Host to retrieve from
|
|
|
|
[Parameter(Mandatory = $false, ParameterSetName = 'remote')]
|
|
|
|
[string]
|
2020-01-03 11:23:25 +00:00
|
|
|
$ComputerName,
|
|
|
|
|
|
|
|
# Use local machine's registry setting to infer remote machine's log path
|
|
|
|
[Parameter(Mandatory = $false, ParameterSetName = 'remote')]
|
|
|
|
[switch]
|
|
|
|
$InferPath
|
2019-11-01 08:20:21 +00:00
|
|
|
)
|
|
|
|
|
|
|
|
process {
|
|
|
|
if($PSCmdlet.ParameterSetName -eq 'remote') {
|
2020-01-03 11:23:25 +00:00
|
|
|
|
|
|
|
if($InferPath) {
|
|
|
|
# Get local registry key entry
|
|
|
|
$localPath = [Environment]::ExpandEnvironmentVariables((Get-ItemProperty -Path ("HKLM:\SOFTWARE\Policies\Microsoft\WindowsFirewall\{0}Profile\Logging" -f $LogProfile) -Name "LogFilePath").LogFilePath)
|
|
|
|
|
|
|
|
if($null -eq $localPath) {
|
|
|
|
$defaultPath = "$ENV:SystemRoot\system32\LogFiles\Firewall\pfirewall.log"
|
|
|
|
Write-Warning "Path for $LogProfile firewall log not defined in registry. Assuming default path of $defaultPath"
|
|
|
|
$localPath = $defaultPath
|
2019-11-01 08:20:21 +00:00
|
|
|
}
|
|
|
|
}
|
2020-01-03 11:23:25 +00:00
|
|
|
else {
|
|
|
|
$serviceName = "RemoteRegistry"
|
|
|
|
$startTypeChanged = $false
|
|
|
|
$statusChanged = $false
|
2019-11-01 08:20:21 +00:00
|
|
|
|
2020-01-03 11:23:25 +00:00
|
|
|
Write-Verbose "Retrieving path from registry on host $ComputerName."
|
|
|
|
$remoteRegistry = Get-Service -ComputerName $ComputerName -Name $serviceName
|
|
|
|
|
|
|
|
if($remoteRegistry.StartType -eq "Disabled") {
|
|
|
|
Write-Verbose "$serviceName service is Disabled. Attempting to change to Manual startup."
|
|
|
|
Set-Service -StartupType "Manual" -Name $serviceName -ComputerName $ComputerName
|
|
|
|
$modifiedRemoteRegistry = Get-Service -Name $serviceName -ComputerName $ComputerName
|
2019-11-01 08:20:21 +00:00
|
|
|
|
2020-01-03 11:23:25 +00:00
|
|
|
if($modifiedRemoteRegistry.StartType -ne "Manual") {
|
|
|
|
Write-Warning "Unable to change startup of $serviceName on host $ComputerName."
|
|
|
|
return $null
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
Write-Verbose "$serviceName startup changed to Manual."
|
|
|
|
$startTypeChanged = $true
|
|
|
|
}
|
2019-11-01 08:20:21 +00:00
|
|
|
}
|
2020-01-03 11:23:25 +00:00
|
|
|
|
|
|
|
if($remoteRegistry.Status -ne "Running") {
|
|
|
|
Write-Verbose "$serviceName service is not running. Attempting to start."
|
|
|
|
Set-Service -Status "Running" -Name $serviceName -ComputerName $ComputerName
|
|
|
|
$modifiedRemoteRegistry = Get-Service -Name $serviceName -ComputerName $ComputerName
|
|
|
|
|
|
|
|
if($modifiedRemoteRegistry.Status -eq "Stopped") {
|
|
|
|
Write-Warning "Unable to start $serviceName service on host $ComputerName."
|
|
|
|
return $null
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
Write-Verbose "$serviceName service started OK."
|
|
|
|
$statusChanged = $true
|
|
|
|
}
|
2019-11-01 08:20:21 +00:00
|
|
|
}
|
|
|
|
|
2020-01-03 11:23:25 +00:00
|
|
|
$reg = [Microsoft.Win32.RegistryKey]::OpenRemoteBaseKey('LocalMachine', $ComputerName)
|
|
|
|
$regKey = $reg.OpenSubKey("SOFTWARE\\Policies\\Microsoft\\WindowsFirewall\\{0}Profile\Logging" -f $LogProfile)
|
|
|
|
$localPath = [Environment]::ExpandEnvironmentVariables($RegKey.GetValue("LogFilePath"))
|
2019-11-01 08:20:21 +00:00
|
|
|
|
2020-01-03 11:23:25 +00:00
|
|
|
# Set Remote Registry back the way we found it if we had to change it
|
2019-11-01 08:20:21 +00:00
|
|
|
|
2020-01-03 11:23:25 +00:00
|
|
|
if($statusChanged) {
|
|
|
|
Write-Verbose ("Reverting status of $serviceName Service to {0}." -f $remoteRegistry.Status)
|
|
|
|
# Set-Service -Name $serviceName -ComputerName $ComputerName -Status $remoteRegistry.Status
|
|
|
|
# Need to use Invoke-Command as Set-Service won't stop a service that has dependencies
|
|
|
|
Invoke-Command -ComputerName $ComputerName -ScriptBlock { Stop-Service -Name "RemoteRegistry" }
|
|
|
|
|
|
|
|
# Verify that service has been restored to its original state.
|
|
|
|
$revertedRemoteRegistry = Get-Service -Name $serviceName -ComputerName $ComputerName
|
|
|
|
if($remoteRegistry.Status -ne $revertedRemoteRegistry.Status) {
|
|
|
|
Write-Warning "Failed to revert $serviceName status to $($remoteRegistry.Status)!"
|
|
|
|
}
|
2019-11-01 08:20:21 +00:00
|
|
|
}
|
|
|
|
|
2020-01-03 11:23:25 +00:00
|
|
|
if($startTypeChanged) {
|
|
|
|
Write-Verbose ("Reverting Startup of $serviceName Service to {0}." -f $remoteRegistry.StartType)
|
|
|
|
Set-Service -Name $serviceName -ComputerName $ComputerName -StartupType $remoteRegistry.StartType
|
|
|
|
|
|
|
|
# Verify that service has been restored to its original state.
|
|
|
|
if($remoteRegistry.StartType -ne $revertedRemoteRegistry.StartType) {
|
|
|
|
Write-Warning "Failed to revert startup type of $serviceName to $($remoteRegistry.StartType)!"
|
|
|
|
}
|
2019-11-01 08:20:21 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
# Do the conversion to UNC path
|
|
|
|
$path = "\\$ComputerName\" + $localPath.replace(':', '$')
|
|
|
|
|
|
|
|
return $path
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
# Get local registry key entry
|
|
|
|
$path = [Environment]::ExpandEnvironmentVariables((Get-ItemProperty -Path ("HKLM:\SOFTWARE\Policies\Microsoft\WindowsFirewall\{0}Profile\Logging" -f $LogProfile) -Name "LogFilePath").LogFilePath)
|
|
|
|
|
|
|
|
if($null -eq $path) {
|
2020-01-03 11:23:25 +00:00
|
|
|
$defaultPath = "$ENV:SystemRoot\system32\LogFiles\Firewall\pfirewall.log"
|
|
|
|
Write-Warning "Path for $LogProfile firewall log not defined in registry. Assuming default path of $defaultPath"
|
|
|
|
$path = $defaultPath
|
2019-11-01 08:20:21 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
return $path
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|