Operação SetHoldOnMailboxes
Importante
A partir de 1º de abril de 2020, a operação SetHoldOnMailboxes não estará mais disponível no Exchange Online. Essa operação não será afetada em versões locais do Exchange Server. Para obter mais informações, consulte Aposentadoria de ferramentas de descoberta eletrônica herdadas no Exchange Online.
Encontre informações sobre a operação EWS SetHoldOnMailboxes .
A operação SetHoldOnMailboxes define uma política de retenção de caixa de correio em caixas de correio.
This operation was introduced in Exchange Server 2013.
Usando a operação SetHoldOnMailboxes
A operação SetHoldOnMailboxes define uma retenção de caixa de correio em uma ou mais caixas de correio.
Cabeçalhos SOAP da operação SetHoldOnMailboxes
A operação SetHoldOnMailboxes pode usar os cabeçalhos SOAP listados na tabela a seguir.
| Nome de cabeçalho | Elemento | Descrição |
|---|---|---|
| Managementrole |
Managementrole |
Identifica as funções de servidor necessárias para que o chamador faça a solicitação. Esse cabeçalho é aplicável a uma solicitação. |
| RequestVersion |
RequestServerVersion |
Identifica a versão do esquema para a solicitação de operação. Esse cabeçalho é aplicável a uma solicitação. |
| Serverversion |
ServerVersionInfo |
Identifica a versão do servidor que respondeu à solicitação. Esse cabeçalho é aplicável a uma resposta. |
Exemplo de solicitação de operação SetHoldOnMailboxes: aplicar um porão em uma caixa de correio
O exemplo a seguir de uma solicitação de operação SetHoldOnMailboxes mostra como aplicar um porão em duas caixas de correio. O porão da caixa de correio foi criado usando o comando New-MailboxSearch .
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013" />
</soap:Header>
<soap:Body >
<m:SetHoldOnMailboxes>
<m:ActionType>Create</m:ActionType>
<m:HoldId>HoldId2</m:HoldId>
<m:Query>test</m:Query>
<m:Mailboxes>
<t:String>/o=First/ou=Exchange(DLT)/cn=Recipients/cn=1fa441ff5e4749ba43ecc0fd94c21adf-Willi</t:String>
<t:String>/o=First/ou=Exchange(DLT)/cn=Recipients/cn=aed2346adaa34ffc9f0f339917e8de95-Micha</t:String>
</m:Mailboxes>
<m:Language>English</m:Language>
<m:IncludeNonIndexableItems>false</m:IncludeNonIndexableItems>
<m:Deduplication>true</m:Deduplication>
</m:SetHoldOnMailboxes>
</soap:Body>
</soap:Envelope>
O corpo SOAP de solicitação contém os seguintes elementos:
Resposta bem-sucedida da operação SetHoldOnMailboxes
O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação de operação SetHoldOnMailboxes para colocar duas caixas de correio em espera.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="526"
MinorBuildNumber="0"
Version="Exchange2013"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SetHoldOnMailboxesResponse ResponseClass="Success"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<MailboxHoldResult>
<HoldId xmlns="http://schemas.microsoft.com/exchange/services/2006/types">HoldId2</HoldId>
<Query xmlns="http://schemas.microsoft.com/exchange/services/2006/types">test</Query>
<MailboxHoldStatuses xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
<MailboxHoldStatus>
<Mailbox>o=First/ou=Exchange(DLT)/cn=Recipients/cn=1fa441ff5e4749ba43ecc0fd94c21adf-Willi</Mailbox>
<Status>Pending</Status>
<AdditionalInfo/>
</MailboxHoldStatus>
<MailboxHoldStatus>
<Mailbox>/o=First/ou=Exchange(DLT)/cn=Recipients/cn=aed2346adaa34ffc9f0f339917e8de95-Micha</Mailbox>
<Status>Pending</Status>
<AdditionalInfo/>
</MailboxHoldStatus>
</MailboxHoldStatuses>
</MailboxHoldResult>
</SetHoldOnMailboxesResponse>
</s:Body>
</s:Envelope>
O corpo SOAP de resposta contém os seguintes elementos:
Resposta de erro da operação SetHoldOnMailboxes
O exemplo a seguir mostra uma resposta de erro a uma solicitação de operação SetHoldOnMailboxes . Essa é uma resposta a uma solicitação que contém um identificador de caixa de correio especificado incorretamente.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="526"
MinorBuildNumber="0"
Version="Exchange2013"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SetHoldOnMailboxesResponse ResponseClass="Error"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<MessageText>No mailbox is specified for hold operation. If specified in the request, then it could be the object does not exist in AD or is a Distribution Group.</MessageText>
<ResponseCode>ErrorInvalidOperation</ResponseCode>
<DescriptiveLinkKey>0</DescriptiveLinkKey>
</SetHoldOnMailboxesResponse>
</s:Body>
</s:Envelope>
O corpo SOAP de resposta de erro contém os seguintes elementos:
Para obter códigos de erro adicionais que são genéricos para o EWS e específicos para essa operação, consulte ResponseCode.