Set-UMMailboxPIN

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Set-UMMailboxPIN para redefinir o PIN de uma caixa de correio habilitada para UM (Unificação de Mensagens).

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Set-UMMailboxPIN
   [-Identity] <MailboxIdParameter>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-IgnoreDefaultScope]
   [-LockedOut <Boolean>]
   [-NotifyEmail <String>]
   [-Pin <String>]
   [-PINExpired <Boolean>]
   [-SendEmail <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

O cmdlet Set-UMMailboxPIN é usado quando um usuário habilitado para UM foi bloqueado em uma caixa de correio porque tentou fazer logon com um PIN incorreto várias vezes ou porque esqueceu o seu PIN. Você pode usar este cmdlet para definir o PIN do usuário. O novo PIN deve ser compatível com as regras de diretiva de PIN especificadas na diretiva de caixa de correio do usuário. O novo PIN é enviado para o usuário em um email ou para um endereço de email alternativo. É possível controlar se o usuário deverá definir o PIN ao fazer logon e se a caixa de correio continuará bloqueada.

Quando essa tarefa é concluída, o PIN em uma caixa de correio habilitada para UM é definido.

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

Set-UMMailboxPIN -Identity tonysmith@contoso.com

Este exemplo redefine o PIN na caixa de correio habilitada para UM para tonysmith@contoso.com.

Exemplo 2

Set-UMMailboxPIN -Identity tonysmith@contoso.com -PIN 1985848 -PinExpired $true

Este exemplo redefine o PIN inicial para 1985848 na caixa de correio habilitada para UM para tonysmith@contoso.come, em seguida, define o PIN como expirado para que o usuário seja solicitado a alterar o PIN na próxima vez que o usuário fizer logon.

Exemplo 3

Set-UMMailboxPIN -Identity tonysmith@contoso.com -LockedOut $true

Este exemplo bloqueia a caixa de correio habilitada para UM para tonysmith@contoso.com impedir que o usuário acesse a caixa de correio.

Exemplo 4

Set-UMMailboxPIN -Identity tonysmith@contoso.com -LockedOut $false

Este exemplo desbloqueia a caixa de correio habilitada para tonysmith@contoso.com UM e permite que o usuário acesse a caixa de correio.

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

-DomainController

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

-Identity

O parâmetro Identity especifica a caixa de correio que você deseja modificar. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. 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
Type:MailboxIdParameter
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

-IgnoreDefaultScope

A opção IgnoreDefaultScope informa ao comando para ignorar a configuração de escopo padrão do destinatário para a sessão do Exchange PowerShell e usar toda a floresta como o escopo. Não é preciso especificar um valor com essa opção.

Essa opção permite que o comando acesse objetos do Active Directory que não estão disponíveis no momento no escopo padrão, mas também introduz as seguintes restrições:

  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.
Type:SwitchParameter
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

-LockedOut

O parâmetro LockedOut especifica se a caixa de correio continuará bloqueada. Se definido como $true, a caixa de correio será marcada como bloqueada. Por padrão, se esse parâmetro for omitido ou definido como $false, o comando limpará o status bloqueado na caixa de correio.

Type:Boolean
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

-NotifyEmail

O parâmetro NotifyEmail especifica o endereço de email para o qual o servidor enviará a mensagem de email contendo as informações de redefinição do PIN. Por padrão, a mensagem é enviada para o endereço SMTP do usuário habilitado.

Type:String
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

-Pin

O parâmetro Pin especifica um novo PIN para ser usado com a caixa de correio. O PIN é comparado com as regras de PIN definidas na diretiva de caixa de correio de Unificação de Mensagens. Se o PIN não for fornecido, o comando gerará um novo PIN para a caixa de correio e o incluirá em uma mensagem de email enviada para o usuário.

Type:String
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

-PINExpired

O parâmetro PINExpired especifica se o PIN é tratado como expirado. Se esse parâmetro for fornecido e definido como $false, o usuário não precisará redefinir o PIN na próxima vez que fizer logon. Se não for fornecido, o PIN será tratado como expirado e o usuário será solicitado a redefinir seu PIN na próxima vez que fizer logon.

Type:Boolean
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

-SendEmail

O parâmetro SendEmail especifica se um PIN deverá ser enviado para o usuário em um email. O padrão é $true.

Type:Boolean
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

-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

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.