EWS::Client::DistributionList - Distribution List Entries from Microsoft Exchange Server
version 1.143070
First set up your Exchange Web Services client as per EWS::Client:
use EWS::Client; my $ews = EWS::Client->new({ server => 'exchangeserver.example.com', username => 'oliver', password => 's3krit', # or set in $ENV{EWS_PASS} });
Then retrieve the distribution list entries:
my $entries = $ews->distribution_list->retrieve( email => 'group@example.com'); # OR $entries = $ews->distribution_list->expand('group@example.com'); print "I retrieved ". $entries->count ." items\n"; while ($entries->has_next) { print $entries->next->EmailAddress, "\n"; }
This module allows you to retrieve the set of Distribution List entries for an email address on a Microsoft Exchange server. At present only read operations are supported. The results are available in an iterator and convenience methods exist to access the properties of each entry.
You would not normally call this constructor. Use the EWS::Client constructor instead.
Instantiates a new distribution list reader. Note that the action of performing a query for a set of results is separated from this step, so you can perform multiple queries using this same object. Pass the following arguments in a hash ref:
client
EWS::Client
An instance of EWS::Client which has been configured with your server location, user credentials and SOAP APIs. This will be stored as a weak reference.
Query the Exchange server and retrieve Mailbox members of the distribution list. Accepts the following arguments:
distribution_email
Passing the primary SMTP address of a distribution list will retrieve the members for that list, assuming it is public or you have right to see the private list. If you do not have rights, an error will be thrown.
If you pass one of the account's secondary SMTP addresses this module should be able to divine the primary SMTP address required.
impersonate
In addition to passing the 'distribution_email', passing the primary SMTP address of another account will retrieve the requested private distribution list for the impersonated user. If you do not have sufficient rights to Impersonate that user, an error will be thrown.
By default the retrieve() method will return distribution list members for public distribution lists or private lists you have access to using the account under which you authenticated to the Exchange server (that is, the credentials passed to the EWS::Client constructor). This argument will change that behaviour.
retrieve()
The returned object contains the collection of distribution list members and is of type EWS::DistributionList::ResultSet. It's an iterator, so you can walk through the list of entries (see the synposis, above). For example:
EWS::DistributionList::ResultSet
my $entries = $distribution_list->retrieve({distribution_email => 'group@example.com'});
This is a convenience method for passing a just a distribution_email attribute:
$distribution_list->expand('group@example.com'); #is identical to: $distribution_list->retrieve({distribution_email => 'group@example.com'});
Provides the next mailbox in the collection of distribution list entries, or undef if there are no more mailboxes to return. Usually used in a loop along with has_next like so:
undef
has_next
while ($entries->has_next) { print $entries->next->Name, "\n"; }
Returns the next item without moving the state of the iterator forward. It returns undef if it is at the end of the collection and there are no more mailboxes to return.
Returns a true value if there is another entry in the collection after the current item, otherwise returns a false value.
Resets the iterator's cursor, so you can walk through the entries again from the start.
Returns the number of entries returned by the retrieve server query.
retrieve
Returns an array ref containing all the entries returned by the retrieve server query. They are each objects of type EWS::DistributionList::Mailbox.
EWS::DistributionList::Mailbox
Attribute contains the name of the mailbox user..
Attribute contains the Simple Mail Transfer Protocol (SMTP) address of a mailbox user.
Attribute contains mailbox type of a mailbox user.
Attribute contains routing that is used for the mailbox. The default is SMTP.
http://msdn.microsoft.com/en-us/library/aa580675.aspx
Oliver Gorwits <oliver@cpan.org> John Judd <jjudd@cpan.org>
This software is copyright (c) 2013 by University of Oxford.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
Oliver Gorwits <oliver@cpan.org>
This software is copyright (c) 2014 by University of Oxford.
To install EWS::Client, copy and paste the appropriate command in to your terminal.
cpanm
cpanm EWS::Client
CPAN shell
perl -MCPAN -e shell install EWS::Client
For more information on module installation, please visit the detailed CPAN module installation guide.