Skip to main content

ConvertFrom-MailAuthenticationRecordDmarc

SYNOPSIS​

Returns structured RFC compliant object for a DMARC record

SYNTAX​

ConvertFrom-MailAuthenticationRecordDmarc [-DomainName] <String> [[-DnsServerIpAddress] <IPAddress>]
[-QuickTimeout] [-NoHostsFile] [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION​

Adapted from:

record               : v=DMARC1; p=reject; pct=100; rua=mailto:[email protected]; ruf=mailto:[email protected]; fo=1
valid : True
policy : reject
policySubdomain :
percentage : 100
reportAggregate : {DMARCRecordUri}
reportForensic : {DMARCRecordUri}
reportFailure : {1}
reportFailureFormats : {afrf}
reportFrequency : 86400
alignmentDkim : r
alignmentSpf : r
version : DMARC1
warnings : {sp: No subdomain policy set, adkim: No DKIM alignment set, defaults to relaxed, aspf: No SPF alignment set, defaults to relaxed, ri: No
report interval set, defaults to 86400 seconds…}

EXAMPLES​

EXAMPLE 1​

ConvertFrom-MailAuthenticationRecordDmarc -DomainName "microsoft.com"

Returns [DMARCRecord] or "Failure to obtain record"

PARAMETERS​

-DomainName​

Domain name to check.

Type: String
Parameter Sets: (All)
Aliases:

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

-DnsServerIpAddress​

DNS-server to use for lookup.

Type: IPAddress
Parameter Sets: (All)
Aliases:

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

-QuickTimeout​

Use a shorter timeout value for the DNS lookup.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-NoHostsFile​

Ignore hosts file for domain lookup.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ProgressAction​

{{ Fill ProgressAction Description }}

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​

ConvertFrom-MailAuthenticationRecordDmarc.DMARCRecord​

System.String​

NOTES​

https://maester.dev/docs/commands/ConvertFrom-MailAuthenticationRecordDmarc