mirror of
https://github.com/EvotecIT/GPOZaurr.git
synced 2026-07-26 11:49:17 +00:00
Przemyslaw Klys
73 lines
2.6 KiB
PowerShell
73 lines
2.6 KiB
PowerShell
function Remove-GPOZaurrWMI {
|
|
<#
|
|
.SYNOPSIS
|
|
Removes Group Policy WMI filters based on specified criteria.
|
|
|
|
.DESCRIPTION
|
|
This function removes WMI filters based on the provided GUIDs or names within the specified forest or domains. It retrieves WMI filters associated with the GPOs and removes them.
|
|
|
|
.PARAMETER Guid
|
|
Specifies an array of GUIDs of the WMI filters to be removed.
|
|
|
|
.PARAMETER Name
|
|
Specifies an array of names of the WMI filters to be removed.
|
|
|
|
.PARAMETER Forest
|
|
Specifies the forest name where the WMI filters are located.
|
|
|
|
.PARAMETER ExcludeDomains
|
|
Specifies an array of domains to exclude from the removal process.
|
|
|
|
.PARAMETER IncludeDomains
|
|
Specifies an array of domains to include in the removal process.
|
|
|
|
.PARAMETER ExtendedForestInformation
|
|
Specifies additional information about the forest.
|
|
|
|
.EXAMPLE
|
|
Remove-GPOZaurrWMI -Guid "12345678-1234-1234-1234-123456789012"
|
|
|
|
Description
|
|
-----------
|
|
Removes the WMI filter with the specified GUID.
|
|
|
|
.EXAMPLE
|
|
Remove-GPOZaurrWMI -Name "TestWMIFilter"
|
|
|
|
Description
|
|
-----------
|
|
Removes the WMI filter with the specified name.
|
|
|
|
#>
|
|
[CmdletBinding(SupportsShouldProcess)]
|
|
Param (
|
|
[Guid[]] $Guid,
|
|
[string[]] $Name,
|
|
|
|
[alias('ForestName')][string] $Forest,
|
|
[string[]] $ExcludeDomains,
|
|
[alias('Domain', 'Domains')][string[]] $IncludeDomains,
|
|
[System.Collections.IDictionary] $ExtendedForestInformation
|
|
)
|
|
if (-not $Forest -and -not $ExcludeDomains -and -not $IncludeDomains -and -not $ExtendedForestInformation) {
|
|
$IncludeDomains = $Env:USERDNSDOMAIN
|
|
}
|
|
$ForestInformation = Get-WinADForestDetails -Forest $Forest -IncludeDomains $IncludeDomains -ExcludeDomains $ExcludeDomains -ExtendedForestInformation $ExtendedForestInformation
|
|
foreach ($Domain in $ForestInformation.Domains) {
|
|
$QueryServer = $ForestInformation['QueryServers'][$Domain]['HostName'][0]
|
|
[Array] $Objects = @(
|
|
if ($Guid) {
|
|
Get-GPOZaurrWMI -Guid $Guid -ExtendedForestInformation $ForestInformation -IncludeDomains $Domain
|
|
}
|
|
if ($Name) {
|
|
Get-GPOZaurrWMI -Name $Name -ExtendedForestInformation $ForestInformation -IncludeDomains $Domain
|
|
}
|
|
)
|
|
$Objects | ForEach-Object -Process {
|
|
if ($_.DistinguishedName) {
|
|
Write-Verbose "Remove-GPOZaurrWMI - Removing WMI Filter $($_.DistinguishedName)"
|
|
Remove-ADObject $_.DistinguishedName -Confirm:$false -Server $QueryServer
|
|
}
|
|
}
|
|
}
|
|
} |