ConvertFrom-MailAuthenticationRecordSpf
SYNOPSIS
Returns a structured RFC compliant object for the supplied SPF record
SYNTAX
ConvertFrom-MailAuthenticationRecordSpf [-DomainName] <String> [[-DnsServerIpAddress] <IPAddress>]
[-QuickTimeout] [-NoHostsFile] [-ProgressAction <ActionPreference>] [<CommonParameters>]
DESCRIPTION
Adapted from:
- https://cloudbrothers.info/en/powershell-tip-resolve-spf/
- https://github.com/cisagov/ScubaGear/blob/main/PowerShell/ScubaGear/Modules/Providers/ExportEXOProvider.psm1
- https://xkln.net/blog/getting-mx-spf-dmarc-dkim-and-smtp-banners-with-powershell/
- SPF https://datatracker.ietf.org/doc/html/rfc7208
record : v=spf1 include:_spf-a.microsoft.com include:_spf-b.microsoft.com include:_spf-c.microsoft.com include:_spf-ssg-a.msft.net include:spf-a.hotmail.com
include:_spf1-meo.microsoft.com -all
terms : {SPFRecordTerm, SPFRecordTerm, SPFRecordTerm, SPFRecordTerm…}
warnings :
EXAMPLES
EXAMPLE 1
ConvertFrom-MailAuthenticationRecordSpf -DomainName "microsoft.com"
Returns [SPFRecord] object 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-MailAuthenticationRecordSpf.SPFRecord
System.String
NOTES
RELATED LINKS
https://maester.dev/docs/commands/ConvertFrom-MailAuthenticationRecordSpf