Remove-MailboxImportRequest
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.
Use o cmdlet Remove-MailboxImportRequest para remover completamente ou parcialmente as solicitações de importação concluídas. As solicitações de importação concluídas não são limpas automaticamente. As solicitações devem ser removidas usando o cmdlet Remove-MailboxImportRequest. Diversas solicitações de importação podem existir contra a mesma caixa de correio se você oferecer um nome de solicitação de importação distinto.
OBSERVAÇÃO: esse cmdlet não tem mais suporte em Exchange Online. Para importar um arquivo .pst no Exchange Online, consulte Usar o upload de rede para importar arquivos PST.
Esse cmdlet está disponível apenas na função Exportação de Importação de Caixa de Correio e, por padrão, a função não é atribuída a nenhum grupo de funções. Para usar esse cmdlet, você precisa adicionar a função Exportação de Importação de Caixa de Correio a um grupo de funções (por exemplo, ao grupo de funções gerenciamento de organização). Para obter mais informações, consulte Adicionar uma função a um grupo de funções.
A remoção de uma solicitação de importação parcialmente concluída remove a solicitação da fila de trabalho mrs (serviço de replicação de caixa de correio do Exchange) Microsoft. Qualquer progresso de importação que for feito até a remoção não será revertido.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Remove-MailboxImportRequest
[-Identity] <MailboxImportRequestIdParameter>
[-Force]
[-Confirm]
[-DomainController <Fqdn>]
[-WhatIf]
[<CommonParameters>]
Remove-MailboxImportRequest
-RequestGuid <Guid>
-RequestQueue <DatabaseIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-WhatIf]
[<CommonParameters>]
Description
O parâmetro definido que solicita o parâmetro Identity permite que você remova completa ou parcialmente uma solicitação de importação concluída.
O parâmetro definido que solicita os parâmetros RequestGuid e RequestQueue é usado somente para fins de depuração do MRS.
Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Remove-MailboxImportRequest -Identity "Ayla\MailboxImport1"
Este exemplo remove a segunda solicitação de importação para a caixa de correio Ayla\MailboxImport1 de Ayla.
Exemplo 2
Remove-MailboxImportRequest -RequestQueue MBXDB01 -RequestGuid 25e0eaf2-6cc2-4353-b83e-5cb7b72d441f
Este exemplo cancela a solicitação de importação usando o parâmetro RequestGuid para a caixa de correio ou arquivo no MBXDB01.
Exemplo 3
Get-MailboxImportRequest -Status Completed | Remove-MailboxImportRequest
Este exemplo remove todas as solicitações de Importação concluídas.
Parâmetros
-Confirm
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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Este parâmetro está disponível somente no Exchange local.
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.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
O parâmetro Identity especifica a identidade da solicitação da importação. Por padrão, as solicitações de importação são nomeadas <alias>\MailboxImportX
(em que X = 0-9). Se você criou a solicitação usando o parâmetro Nome, use a seguinte sintaxe: Alias\Name
.
Você não pode usar esse parâmetro com o parâmetro RequestGuid.
Type: | MailboxImportRequestIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RequestGuid
Este parâmetro está disponível somente no Exchange local.
O parâmetro RequestGuid (juntamente com o parâmetro RequestQueue) especifica o identificador exclusivo para a solicitação de importação. Para localizar a GUID de solicitação de importação, use o cmdlet Get-MailboxImportRequest.
Nome do banco de dados
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RequestQueue
Este parâmetro está disponível somente no Exchange local.
O parâmetro RequestQueue identifica a solicitação com base no banco de dados da caixa de correio em que a solicitação está sendo executada. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Nome do banco de dados
Type: | DatabaseIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
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.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.