UWF_RegistryFilter

發行項
07/22/2023

從整合寫入篩選 (UWF) 篩選新增或移除登錄排除專案，同時認可登錄變更。

語法

class UWF_RegistryFilter{
    [key, Read] boolean CurrentSession;
    [Read, Write] boolean PersistDomainSecretKey;
    [Read, Write] boolean PersistTSCAL;

    UInt32 AddExclusion(
        string RegistryKey
    );
    UInt32 RemoveExclusion(
        string RegistryKey
    );
    UInt32 FindExclusion(
        [in] string RegistryKey,
        [out] boolean bFound
    );
    UInt32 GetExclusions(
        [out, EmbeddedInstance("UWF_ExcludedRegistryKey")] string ExcludedKeys[]
    );
    UInt32 CommitRegistry(
        [in] string RegistryKey,
        [in] string ValueName
    );
    UInt32 CommitRegistryDeletion(
        string Registrykey,
        string ValueName
    );
};

成員

下表列出屬於這個類別的方法和屬性。

方法	描述
UWF_RegistryFilter.AddExclusion	將登錄機碼新增至 UWF 的登錄排除清單。
UWF_RegistryFilter.CommitRegistry	認可指定登錄機碼和值的變更。
UWF_RegistryFilter.CommitRegistryDeletion	刪除指定的登錄機碼或登錄值，並認可刪除。
UWF_RegistryFilter.FindExclusion	判斷是否要排除特定登錄機碼，而不受 UWF 篩選。
UWF_RegistryFilter.GetExclusions	從受 UWF 保護的系統擷取所有登錄機碼排除專案
UWF_RegistryFilter.RemoveExclusion	從整合寫入篩選 (UWF) 的登錄排除清單中移除登錄機碼。

屬性

屬性	資料類型	限定詞	描述
CurrentSession	Boolean	[key， read]	指出物件包含設定的會話。 - 如果目前會話 - 的設定為False，則為 True，如果設定是後續重新開機的下一個會話。
PersistDomainSecretKey	Boolean	[讀取，寫入]	指出網域秘密登錄機碼是否位於登錄排除清單中。如果登錄機碼不在排除清單中，則重新開機後不會保存變更。 - True表示包含在排除清單中 - 否則為 False。
PersistTSCAL	Boolean	[讀取，寫入]	指出終端機伺服器用戶端存取授權 (TSCAL) 登錄機碼是否位於 UWF 登錄排除清單中。如果登錄機碼不在排除清單中，則重新開機後不會保存變更。 - True 表示包含在排除清單中 - 否則設定為 False

備註

新增或移除登錄排除專案，包括 PersistDomainSecretKey 和 PersistTSCAL值的變更，會在啟用 UWF 的下一次重新開機之後生效。

您只能將 HKLM 登錄根目錄中的登錄機碼新增至 UWF 登錄排除清單。

您也可以使用 UWF_RegistryFilter ，從 UWF 篩選中排除網域秘密登錄機碼和 TSCAL 登錄機碼。

範例

下列範例示範如何在 PowerShell 腳本中使用 Windows Management Instrumentation (WMI) 提供者來管理 UWF 登錄排除專案。

PowerShell 腳本會建立四個函式，然後示範如何使用它們。

第一個函式 Get-RegistryExclusions會顯示目前會話的 UWF 登錄排除專案清單，以及重新開機之後的下一個會話。

第二個 函式 Add-RegistryExclusion會在您重新開機裝置之後，將登錄專案新增至 UWF 登錄排除清單。

第三個函式 Remove-RegistryExclusion會在您重新開機裝置之後，從 UWF 排除清單中移除登錄專案。

第四個 函式 Clear-RegistryExclusions會移除所有 UWF 登錄排除專案。您必須在 UWF 停止篩選排除專案之前重新開機裝置。

$COMPUTER = "EMBEDDEDDEVICE"
$NAMESPACE = "root\standardcimv2\embedded"

# Define common parameters

$CommonParams = @{"namespace"=$NAMESPACE; "computer"=$COMPUTER}

function Get-RegistryExclusions() {

# This function lists the UWF registry exclusions, both
# for the current session as well as the next session after a restart.


# Get the UWF_RegistryFilter configuration for the current session

    $currentConfig = Get-WMIObject -class UWF_RegistryFilter @CommonParams |
        where {
            $_.CurrentSession -eq $true
        };

# Get the UWF_RegistryFilter configuration for the next session after a restart

    $nextConfig = Get-WMIObject -class UWF_RegistryFilter @CommonParams |
        where {
            $_.CurrentSession -eq $false
        };

# Display registry exclusions for the current session

    if ($currentConfig) {

        Write-Host ""
        Write-Host "The following registry entries are currently excluded from UWF filtering:";

        $currentExcludedList = $currentConfig.GetExclusions()

        if ($currentExcludedList.ExcludedKeys) {
            foreach ($registryExclusion in $currentExcludedList.ExcludedKeys)  {
                Write-Host "  " $registryExclusion.RegistryKey
            }
        } else {
            Write-Host "  None"
        }
    } else {
        Write-Error "Could not retrieve UWF_RegistryFilter.";
}

# Display registry exclusions for the next session after a restart

    if ($nextConfig) {

        Write-Host ""
        Write-Host "The following registry entries will be excluded from UWF filtering after the next restart:";

        $nextExcludedList = $nextConfig.GetExclusions()

        if ($nextExcludedList.ExcludedKeys) {
            foreach ($registryExclusion in $nextExcludedList.ExcludedKeys)  {
                Write-Host "  " $registryExclusion.RegistryKey
            }
        } else {
            Write-Host "  None"
        }
        Write-Host ""
    }
}

function Add-RegistryExclusion($exclusion) {

# This function adds a new UWF registry exclusion.
# The new registry exclusion takes effect the next time the device is restarted and UWF is enabled.

# $exclusion is the path of the registry exclusion

# Get the UWF_RegistryFilter configuration for the next session after a restart

    $nextConfig = Get-WMIObject -class UWF_RegistryFilter @CommonParams |
        where {
            $_.CurrentSession -eq $false
        };

# Add the exclusion

    if ($nextConfig) {
        $nextConfig.AddExclusion($exclusion) | Out-Null;
        Write-Host "Added exclusion $exclusion.";
    } else {
        Write-Error "Could not retrieve UWF_RegistryFilter";
    }
}

function Remove-RegistryExclusion($exclusion) {

# This function removes a UWF registry exclusion.
# The registry exclusion is removed the next time the device is restarted

# $exclusion is the path of the registry exclusion

# Get the UWF_RegistryFilter configuration for the next session after a restart

    $nextConfig = Get-WMIObject -class UWF_RegistryFilter @CommonParams |
        where {
            $_.CurrentSession -eq $false
        };

# Try to remove the exclusion

    if ($nextConfig) {
        try {
            $nextConfig.RemoveExclusion($exclusion) | Out-Null;
            Write-Host "Removed exclusion $exclusion.";
        } catch {
            Write-Host "Could not remove exclusion $exclusion."
        }
    } else {
        Write-Error "Could not retrieve UWF_RegistryFilter";
    }
}

function Clear-RegistryExclusions() {

# This function removes all UWF registry exclusions
# The registry exclusions are removed the next time the device is restarted

# Get the configuration for the next session

    $nextConfig = Get-WMIObject -class UWF_RegistryFilter @CommonParams |
        where {
            $_.CurrentSession -eq $false
        };

# Remove all registry exclusions

    if ($nextConfig) {

        Write-Host "Removing all registry exclusions:";

        $nextExcludedList = $nextConfig.GetExclusions()

        if ($nextExcludedList) {
            foreach ($registryExclusion in $nextExcludedList.ExcludedKeys)  {
                Write-Host "Removing:" $registryExclusion.RegistryKey
                $nextConfig.RemoveExclusion($registryExclusion.RegistryKey) | Out-Null
            }
        } else {
            Write-Host "No registry exclusions to remove."
        }
        Write-Host ""
    }
}

# Some examples of using the functions

Clear-RegistryExclusions

Get-RegistryExclusions

Add-RegistryExclusion "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer"
Add-RegistryExclusion "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\DateTime\Servers\(Default)"

Get-RegistryExclusions

Remove-RegistryExclusion "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer"

Get-RegistryExclusions

Clear-RegistryExclusions

規格需求

Windows 版本	支援
Windows 首頁	No
Windows 專業版	否
Windows 企業版	是
Windows 教育版	是
Windows IoT 企業版	是的

統一寫入篩選器

UWF_RegistryFilter

語法

成員

屬性

備註

範例

規格需求

相關主題

其他資源