Skip to main content
Version: 2.3.1-preview

Clear-MtADCache

SYNOPSIS​

Resets the local cache of Active Directory data. Use this if you need to force a refresh of the cache in the current session.

SYNTAX​

Clear-MtADCache [[-Categories] <String[]>] [[-ComputerName] <String>] [-ProgressAction <ActionPreference>]
[<CommonParameters>]

DESCRIPTION​

By default all Active Directory data is cached and re-used for the duration of the session.

Use this function to clear the cache and force a refresh of the data from Active Directory.

EXAMPLES​

EXAMPLE 1​

Clear-MtADCache

This example clears the cache of all Active Directory data.

EXAMPLE 2​

Clear-MtADCache -Categories Domain

Clears only the Domain category cache entries for all computers.

EXAMPLE 3​

Clear-MtADCache -ComputerName DC01

Clears only DomainState entries associated with ComputerName DC01 for all categories.

PARAMETERS​

-Categories​

An array of cache categories to clear. Valid values are: Domain, FineGrainedPasswordPolicies, Forest, Computers, Users, Groups, ServiceAccounts, DomainControllers, ReplicationSites, Subnets, OptionalFeatures, ReplicationConnections, DfsrSubscriptions, Trusts, OrganizationalUnits, SmbConfigurations, DNS, Configuration, Schema, Printers, DaclEntries.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ComputerName​

The name of the computer whose DomainState entries should be cleared for the specified categories. If omitted, all computers are affected for the selected categories.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction​

Determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider, such as the progress bars generated by Write-Progress.

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters​

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS​

OUTPUTS​

NOTES​

https://maester.dev/docs/commands/Clear-MtADCache