Test-ExMailboxProxyAddress

SYNOPSIS

Test if a given proxy address exists in the proxy addresses of a mailbox.

SYNTAX

Single

Test-ExMailboxProxyAddress [-Mailbox <string>] [-ProxyAddress <string>] [-MatchOnly] [-NotMatchOnly]

Csv

Test-ExMailboxProxyAddress [-CsvPath <string>] [-MailboxColumn <string>]
 [-ProxyAddressColumn <string>] [-MatchOnly] [-NotMatchOnly]

DESCRIPTION

This cmdlet checks whether a specified proxy address is present in the proxy addresses of a given mailbox. It can process a single mailbox/proxy address pair or read multiple entries from a CSV file.

EXAMPLES

EXAMPLE 1

Test-ExMailboxProxyAddress -Mailbox “user@example.com” -ProxyAddress “alias@example.com” Tests if “alias@example.com” exists in the proxy addresses of the mailbox “user@example.com”.

EXAMPLE 2

Test-ExMailboxProxyAddress -CsvPath “C:\path\to\file.csv” -MailboxColumn “PrimarySmtpAddress” -ProxyAddressColumn “OnMicrosoftAddress” Reads mailbox and proxy address pairs from the specified CSV file and tests each pair.

EXAMPLE 3

Test-ExMailboxProxyAddress -CsvPath “C:\path\to\file.csv” -MatchOnly Reads mailbox and proxy address pairs from the specified CSV file and returns only those that match.

EXAMPLE 4

Test-ExMailboxProxyAddress -CsvPath “C:\path\to\file.csv” -NotMatchOnly Reads mailbox and proxy address pairs from the specified CSV file and returns only those that do not match.

PARAMETERS

-CsvPath

The path to a CSV file containing mailbox and proxy address pairs. This parameter is used when processing multiple entries from a CSV file.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Csv
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Mailbox

The identity of the mailbox to check (e.g., email address, alias, or GUID). This parameter is used when processing a single mailbox/proxy address pair.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Single
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-MailboxColumn

The name of the column in the CSV file that contains mailbox identities. Default is ‘PrimarySmtpAddress’.

Type: System.String
DefaultValue: PrimarySmtpAddress
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Csv
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-MatchOnly

If specified, only returns entries where the proxy address matches.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-NotMatchOnly

If specified, only returns entries where the proxy address does not match.

Type: System.Management.Automation.SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ProxyAddress

The proxy address to check for in the mailbox’s proxy addresses. This parameter is used when processing a single mailbox/proxy address pair.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Single
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ProxyAddressColumn

The name of the column in the CSV file that contains proxy addresses. Default is ‘OnMicrosoftAddress’.

Type: System.String
DefaultValue: OnMicrosoftAddress
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Csv
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

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

INPUTS

OUTPUTS

NOTES

https://ps365.clidsys.com/docs/commands/Test-ExMailboxProxyAddress

Getting started

Azure

Entra

Exchange

Intune

M365 Apps

Misc

MS Commerce

Share Point

Unified Logs

Test-ExMailboxProxyAddress

Test-ExMailboxProxyAddress

SYNOPSIS

SYNTAX

Single

Csv

DESCRIPTION

EXAMPLES

EXAMPLE 1

EXAMPLE 2

EXAMPLE 3

EXAMPLE 4

PARAMETERS

-CsvPath

-Mailbox

-MailboxColumn

-MatchOnly

-NotMatchOnly

-ProxyAddress

-ProxyAddressColumn

CommonParameters

INPUTS

OUTPUTS

NOTES

​Test-ExMailboxProxyAddress

​SYNOPSIS

​SYNTAX

​Single

​Csv

​DESCRIPTION

​EXAMPLES

​EXAMPLE 1

​EXAMPLE 2

​EXAMPLE 3

​EXAMPLE 4

​PARAMETERS

​-CsvPath

​-Mailbox

​-MailboxColumn

​-MatchOnly

​-NotMatchOnly

​-ProxyAddress

​-ProxyAddressColumn

​CommonParameters

​INPUTS

​OUTPUTS

​NOTES

​RELATED LINKS

Test-ExMailboxProxyAddress

SYNOPSIS

SYNTAX

Single

Csv

DESCRIPTION

EXAMPLES

EXAMPLE 1

EXAMPLE 2

EXAMPLE 3

EXAMPLE 4

PARAMETERS

-CsvPath

-Mailbox

-MailboxColumn

-MatchOnly

-NotMatchOnly

-ProxyAddress

-ProxyAddressColumn

CommonParameters

INPUTS

OUTPUTS

NOTES

RELATED LINKS