Skip to content
3.0 preview2.3.0 stable

These docs describe the preview. Pick the version you run and every page marks what it doesn't have yet. Get the preview →
Maester 2.x docs (archived) →

Sponsor

Clear-MtADCache

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

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

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.

Clear-MtADCache

This example clears the cache of all Active Directory data.

Clear-MtADCache -Categories Domain

Clears only the Domain category cache entries for all computers.

Clear-MtADCache -ComputerName DC01

Clears only DomainState entries associated with ComputerName DC01 for all 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

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

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

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

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