New-MailboxExportRequest

A opção AcceptLargeDataLoss especifica que a solicitação deve continuar, mesmo quando um grande número de itens na caixa de correio de origem não pode ser copiado para a caixa de correio de destino. Não é preciso especificar um valor com essa opção.

No Exchange 2013 ou posterior, você precisará usar essa opção se definir o parâmetro LargeItemLimit como um valor de 51 ou mais. Caso contrário, o comando falhará.

No Exchange 2010, você precisa usar essa opção se definir o parâmetro BadItemLimit para um valor de 51 ou superior. Caso contrário, o comando falhará.

O parâmetro AssociatedMessagesCopyOption especifica se as mensagens associadas são copiadas quando a solicitação é processada. As mensagens associadas são mensagens especiais que contêm dados ocultos com informações sobre regras, exibições e formulários. Por padrão, as mensagens associadas são copiadas. Não é possível usar este parâmetro com o parâmetro IncludedRecipients ou qualquer um dos parâmetros Conditional.

• DoNotCopy: as mensagens associadas não são copiadas.
• MapByMessageClass: essa opção localiza a mensagem associada correspondente pesquisando o atributo MessageClass da mensagem de origem. Se houver uma mensagem associada desta classe em ambas as pastas de origem e de destino, ela sobrescreve a mensagem associada no destino. Se não houver mensagem associada no destino, ela cria uma cópia no destino.
• Cópia: essa opção copia mensagens associadas da origem para o destino. Se o mesmo tipo de mensagem existir em ambos os locais de origem e de destino, estas mensagens associadas serão duplicadas. Essa é a opção padrão.

Copy: esta opção copia as mensagens associadas da origem para o destino. Se o mesmo tipo de mensagem existir em ambos os locais de origem e de destino, estas mensagens associadas serão duplicadas. Esta é a opção padrão.

O parâmetro BadItemLimit especifica o número máximo de itens inválidos permitido antes que a solicitação falhe. Um item inválido é um item corrompido na caixa de correio de origem que não pode ser copiado para a caixa de correio de destino. Os itens ausentes também estão incluídos no limite de itens inválidos. Os itens ausentes são itens na caixa de correio de origem que não podem ser encontrados na caixa de correio de destino quando a solicitação está pronta para ser concluída.

Uma entrada válida para esse parâmetro é um número inteiro ou o valor ilimitado. O valor padrão é 0, o que significa que a solicitação falhará se algum item inválido for detectado. Se você não se importar em deixar alguns itens inválidos para trás, poderá definir esse parâmetro com um valor razoável (recomendamos 10 ou menos), de forma que a solicitação possa prosseguir. Se muitos itens inválidos forem detectados, considere o uso do cmdlet New-MailboxRepairRequest para tentar corrigir itens corrompidos na caixa de correio de origem e repita a solicitação.

No Exchange 2010, se você definir esse valor como 51 ou superior, também precisará usar a opção AcceptLargeDataLoss. Caso contrário, o comando falhará.

O parâmetro BatchName especifica um nome descritivo para exportar um lote de caixas de correio. Você pode usar o nome no parâmetro BatchName como uma pesquisa de cadeia de caracteres ao usar o cmdlet Get-MailboxExportRequest.

O parâmetro CompletedRequestAgeLimit especifica por quanto tempo a solicitação será mantida após ter sido concluída antes de ser removida automaticamente. O padrão CompletedRequestAgeLimit é 30 dias.

Esse parâmetro está reservado para uso interno da Microsoft.

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

• Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

O parâmetro ConflictResolutionOption especifica o que fazer se houver várias mensagens correspondentes no destino. Os valores válidos são:

• ForceCopy
• KeepAll
• KeepLatestItem
• KeepLatestItem
• KeepTargetItem
• UpdateFromSource

O parâmetro ContentFilter usa a sintaxe de filtro OPATH para filtrar os resultados pelas propriedades e valores especificados. Apenas o conteúdo correspondente ao parâmetro ContentFilter será exportado para o arquivo .pst. Os critérios de pesquisa usam a sintaxe "Property -ComparisonOperator 'Value'".

• Inclua todo o filtro OPATH nas aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo, $true, $falseou $null), use aspas individuais ' ' em vez disso. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também pode usar chaves { }, mas somente se o filtro não contiver variáveis.
• A propriedade é uma propriedade filtrada. Para propriedades filtradas, consulte Propriedades filtradas para o parâmetro ContentFilter.
• ComparisonOperator é um operador de comparação OPATH (por exemplo -eq , para iguais e -like para comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators.
• Valor é o valor da propriedade a ser pesquisado. Inclua valores e variáveis de texto em aspas individuais ('Value' ou '$Variable'). Se um valor variável contiver aspas individuais, você precisará identificar (escapar) as aspas individuais para expandir a variável corretamente. Por exemplo, em vez de '$User', use '$($User -Replace "'","''")'. Não inclua inteiros ou valores do sistema entre aspas (por exemplo, use 500, $true, $falseou $null em vez disso).

Você pode encadear vários critérios de pesquisa usando os operadores lógicos -and e -or. Por exemplo: "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3".

Para obter informações detalhadas sobre filtros OPATH no Exchange, consulte Informações adicionais de sintaxe OPATH.

O parâmetro ContentFilterLanguage especifica o idioma que é usado no parâmetro ContentFilter para pesquisas de cadeia de caracteres.

A entrada válida para esse parâmetro é um valor de código de cultura com suporte da classe Microsoft .NET Framework CultureInfo. Por exemplo, da-DK para dinamarquês ou ja-JP para japonês. Para obter mais informações, consulte Classe CultureInfo.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

A opção ExcludeDumpster especifica se deve excluir a pasta Itens Recuperáveis. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, a pasta Itens Recuperáveis será copiada com as seguintes subpastas:

• Exclusões
• Versões
• Limpezas

O parâmetro ExcludeFolders especifica a lista de pastas a serem excluídas durante a exportação.

Você precisará definir o parâmetro ImmutableId se o AD FS (Serviços de Federação do exADNoMk) for implantando para permitir o logon único em caixas de correio fora do local e se o AD FS estiver configurado para usar um atributo que não o ExchangeGUID para solicitações de logon de token. Ambos, exExchangeNoVersion e AD FS, devem solicitar o mesmo token para o mesmo usuário a fim de garantir a funcionalidade adequada para um cenário de implantação do exExchangeNoVersion entre locais.

<FolderName>/*: use essa sintaxe para denotar uma pasta pessoal na pasta especificada no parâmetro SourceRootFolder, por exemplo, "MyProjects" ou "MyProjects/FY2010".

#<FolderName>#/*: use essa sintaxe para denotar uma pasta bem conhecida, independentemente do nome da pasta em outro idioma. Por exemplo, #Inbox# indica a pasta Caixa de Entrada, mesmo se a Caixa de Entrada estiver traduzida para Turco, que é Gelen Kutusu. Os tipos de pasta conhecidos incluem os seguintes:

• Caixa de Entrada
• SentItems
• Deleteditems
• Calendário
• Contatos
• Rascunhos
• Diário
• Tarefas
• Observações
• JunkEmail
• CommunicatorHistory
• Caixa postal
• Fax
• Conflitos
• SyncIssues
• LocalFailures
• ServerFailures

Se o usuário criar uma pasta pessoal com o mesmo nome de uma pasta conhecida e o símbolo # ao seu redor, você poderá usar uma barra de fundo (\) como um caractere de escape para especificar essa pasta. Por exemplo, se um usuário criar uma pasta chamada #Notes# e você quiser especificar essa pasta em vez da conhecida pasta Notas, use a seguinte sintaxe: \#Notes\#.

Se o usuário criar uma pasta pessoal com o mesmo nome que uma pasta conhecida e o símbolo # no início e no fim do nome, é possível usar uma barra invertida (\) como um caractere de escape para especificar aquela pasta. Por exemplo, se um usuário cria uma pasta denominada #Notas# e você deseja especificar essa pasta, mas não a pasta Notas conhecida, use a seguinte sintaxe: \#Notes\#.

Para excluir a pasta Itens Recuperáveis, você deve usar o parâmetro ExcludeDumpster.

O parâmetro FilePath especifica o caminho de compartilhamento de rede, para o qual os dados são exportados, por exemplo, \\SERVER01\PST Files\exported.pst.

Você precisa conceder a seguinte permissão para o grupo Subsistema Confiável do Exchange para o compartilhamento da rede pela qual deseja exportar ou importar arquivos PST:

• Para importar arquivos PST do compartilhamento: permissão de leitura
• Para salvar os arquivos PST exportados para o compartilhamento: permissão de leitura/gravação.

Se não conceder esta permissão, você receberá uma mensagem de erro indicando que o Exchange não é capaz de estabelecer uma conexão com o arquivo PST no compartilhamento de rede.

O parâmetro IncludeFolders especifica a lista de pastas a serem incluídas durante a exportação.

Você precisará definir o parâmetro ImmutableId se o AD FS (Serviços de Federação do exADNoMk) for implantando para permitir o logon único em caixas de correio fora do local e se o AD FS estiver configurado para usar um atributo que não o ExchangeGUID para solicitações de logon de token. Ambos, exExchangeNoVersion e AD FS, devem solicitar o mesmo token para o mesmo usuário a fim de garantir a funcionalidade adequada para um cenário de implantação do exExchangeNoVersion entre locais.

<FolderName>/*: use essa sintaxe para denotar uma pasta pessoal na pasta especificada no parâmetro SourceRootFolder, por exemplo, "MyProjects" ou "MyProjects/FY2010".

#<FolderName>#/*: use essa sintaxe para denotar uma pasta bem conhecida, independentemente do nome da pasta em outro idioma. Por exemplo, #Inbox# indica a pasta Caixa de Entrada, mesmo se a Caixa de Entrada estiver traduzida para Turco, que é Gelen Kutusu. Os tipos de pasta conhecidos incluem os seguintes:

• Caixa de Entrada
• SentItems
• Deleteditems
• Calendário
• Contatos
• Rascunhos
• Diário
• Tarefas
• Observações
• JunkEmail
• CommunicatorHistory
• Caixa postal
• Fax
• Conflitos
• SyncIssues
• LocalFailures
• ServerFailures

Se o usuário criar uma pasta pessoal com o mesmo nome de uma pasta conhecida e o símbolo # ao seu redor, você poderá usar uma barra de fundo (\) como um caractere de escape para especificar essa pasta. Por exemplo, se um usuário criar uma pasta chamada #Notes# e você quiser especificar essa pasta em vez da conhecida pasta Notas, use a seguinte sintaxe: \#Notes\#.

Se o usuário criar uma pasta pessoal com o mesmo nome que uma pasta conhecida e o símbolo # no início e no fim do nome, é possível usar uma barra invertida (\) como um caractere de escape para especificar aquela pasta. Por exemplo, se um usuário cria uma pasta denominada #Notas# e você deseja especificar essa pasta, mas não a pasta Notas conhecida, use a seguinte sintaxe: \#Notes\#.

A pasta Itens Recuperáveis sempre será incluída se você não usar o parâmetro ExcludeDumpster, independentemente da lista de pastas fornecidas.

O parâmetro InternalFlags especifica as etapas opcionais na solicitação. Esse parâmetro é usado principalmente para fins de depuração.

A opção IsArchive especifica que você está exportando de arquivo do usuário. Não é preciso especificar um valor com essa opção.

O parâmetro LargeItemLimit especifica o número máximo de itens grandes permitido antes que a solicitação falhe. Um item grande é uma mensagem na caixa de correio de origem que excede o tamanho máximo de mensagem permitido na caixa de correio de destino. Se a caixa de correio de destino não possuir um valor de tamanho de mensagem máximo especificamente configurado, será usado o valor da organização.

Para saber mais sobre valores máximos de tamanho de mensagem, confira os seguintes tópicos:

• Exchange 2016: limites de tamanho da mensagem em Exchange Server
• Exchange Online: Limites do Exchange Online

Uma entrada válida para esse parâmetro é um número inteiro ou o valor ilimitado. O valor padrão é 0, o que significa que a solicitação falhará se algum item grande for detectado. Se você não se importar em deixar alguns itens grandes para trás, poderá definir esse parâmetro com um valor razoável (recomendamos 10 ou menos), de forma que a solicitação possa prosseguir.

Se você definir esse valor como 51 ou superior, também precisará usar a opção AcceptLargeDataLoss. Caso contrário, o comando falhará.

O parâmetro caixa de correio especifica a caixa de correio de origem da qual o conteúdo está sendo exportado.

No Exchange 2016 CU7 ou posterior, esse parâmetro é o tipo MailboxLocationIdParameter, portanto, o valor mais fácil que você pode usar para identificar a caixa de correio é o valor Alias.

No Exchange 2016 CU6 ou anterior, esse parâmetro é o tipo MailboxOrMailUserIdParameter, para que você possa usar qualquer valor que identifique exclusivamente a caixa de correio. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Nome diferenciado (DN)
• Domain\username
• Endereço de email
• GUID
• LegacyExchangeDN
• SamAccountName
• ID de usuário ou nome UPN

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro MRSServer especifica o FQDN do servidor de Acesso para Cliente no qual a instância do MRS do Microsoft Exchange está sendo executada. Esse parâmetro é usado somente para fins de depuração. Use-o somente se receber instruções para fazer isso do pessoal de suporte.

O parâmetro Name especifica o nome da solicitação específica em objetivos de exibição e rastreamento. Como você pode ter várias solicitações de exportação por caixa de correio, o Exchange precede o nome com o alias da caixa de correio. Por exemplo, se você cria uma solicitação de exportação na caixa de correio de um usuário que tem o alias Kweku e especifica o valor deste parâmetro como PC1toArchive, a identidade desta solicitação de exportação será Kweku\PC1toArchive.

Se você não especificar um nome usando esse parâmetro, o Exchange gerará até 10 nomes de solicitação por caixa de correio, que é MailboxExportX (onde X = 0-9). A identidade da solicitação é exibida e pesquisável como <alias>\MailboxExportX.

Esse parâmetro está reservado para uso interno da Microsoft.

O parâmetro Priority especifica a ordem na qual a solicitação deve ser processada na fila de solicitações. As solicitações são processadas em ordem, com base na integridade do servidor, status, prioridade e hora da última atualização. Os valores de prioridade válidos são:

• Inferior
• Baixo
• Normal (este é o valor padrão.)
• Alta
• Superior
• Mais Alta
• Emergência

Esse parâmetro está reservado para uso interno da Microsoft.

Esse parâmetro está reservado para uso interno da Microsoft.

O parâmetro RequestExpiryInterval especifica um limite de idade para uma solicitação concluída ou com falha. Quando você usa esse parâmetro, a solicitação concluída ou que falhou é removida automaticamente depois que o intervalo especificado expira. Se você não usar esse parâmetro:

• A solicitação concluída será removida automaticamente com base no valor de parâmetro CompletedRequestAgeLimit.
• Se a solicitação falhar, você precisará removê-la manualmente usando o cmdlet Remove-*Request correspondente.

Para especificar um valor, insira-o como um período de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.

Quando você usa o valor Unlimited, a solicitação concluída não é removida automaticamente.

O parâmetro SkipMerging especifica as etapas da exportação que devem ser ignoradas. Esse parâmetro é usado principalmente para fins de depuração.

O parâmetro SourceRootFolder especifica a pasta raiz da caixa de correio da qual os dados são exportados. Se este parâmetro não for especificado, o comando exporta todas as pastas.

A opção Suspend especifica se deve suspender a solicitação. Não é preciso especificar um valor com essa opção.

Caso use essa opção, a solicitação é colocada em fila, mas só vai alcançar o status InProgress quando você retomar a solicitação com o cmdlet de resumo relevante.

O parâmetro SuspendComment especifica uma descrição do motivo pelo qual a solicitação foi suspensa. Só é possível usar esse parâmetro se o parâmetro Suspend for especificado.

O parâmetro TargetRootFolder especifica a pasta de nível superior na qual deseja exportar dados. Se você não especificar este parâmetro, o comando exporta o arquivo de início da estrutura de pasta no arquivo .pst de destino. O conteúdo é mesclado sob as pastas existentes e as novas pastas são criadas se elas já não existirem na estrutura de pasta de destino.

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Esse parâmetro está reservado para uso interno da Microsoft.