Get‑WindowsAccessControlMetric

SYNOPSIS

Gets in-process Windows access-control operation metrics.

SYNTAX

Get-WindowsAccessControlMetric [[-CommandName] <String[]>] [[-ObjectFamily] <String[]>]
 [<CommonParameters>]

DESCRIPTION

Returns thread-safe aggregate snapshots containing operation, target, success, failure, and elapsed counts by command and object family. Metrics never include SDDL or account secrets and reset when the module instance is removed or its hosting process exits.

EXAMPLES

EXAMPLE 1

Get-WindowsAccessControlMetric -ObjectFamily RegistryKey

Gets metrics for registry-key operations in the current process.

PARAMETERS

-CommandName

Filters snapshots to one or more exact command names.

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

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

-ObjectFamily

Filters snapshots to one or more exact object-family names.

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

Required: False
Position: 2
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

None

OUTPUTS

WindowsAccessControl.Metric

NOTES

RELATED LINKS