Compartilhar via

Set-UMMailboxPIN

Módulo:
Exchange PowerShell

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.

Sintaxe

Default (Padrão) 

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 é utilizado quando um utilizador com um UM ativado é bloqueado fora de uma caixa de correio porque o utilizador tentou iniciar sessão com um PIN incorreto várias vezes ou porque o utilizador se esqueceu do 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. Pode controlar se o utilizador tem de repor o PIN no início de sessão e se a caixa de correio permanece 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 artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 repõe o PIN na caixa de correio ativada pelo UM para tonysmith@contoso.com.

Exemplo 2

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

Este exemplo repõe o PIN inicial para 1985848 na caixa de correio ativada pelo UM para tonysmith@contoso.come, em seguida, define o PIN como expirado para que seja pedido ao utilizador que altere o PIN da próxima vez que iniciar sessão.

Exemplo 3

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

Este exemplo bloqueia a caixa de correio ativada pelo UM para tonysmith@contoso.com impedir que o utilizador aceda à caixa de correio.

Exemplo 4

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

Este exemplo desbloqueia a caixa de correio ativada pelo UM para tonysmith@contoso.com e permite que o utilizador aceda à caixa de correio.

Parâmetros

-Confirm

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, 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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DomainController

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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.

Propriedades do parâmetro

Tipo:Fqdn
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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)
  • Domínio\Nome de Utilizador
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Propriedades do parâmetro

Tipo:MailboxIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IgnoreDefaultScope

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

O comutador IgnoreDefaultScope indica ao comando para ignorar a definição de âmbito de destinatário predefinida para a sessão do Exchange PowerShell e utilizar toda a floresta como âmbito. Não é preciso especificar um valor com essa opção.

Este comutador permite que o comando aceda a objetos do Active Directory que não estão atualmente disponíveis no âmbito predefinido, 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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LockedOut

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

O parâmetro LockedOut especifica se a caixa de correio está bloqueada fora do UM. Os valores válidos são:

  • $true: a caixa de correio está bloqueada no UM.
  • $false: a status bloqueada na caixa de correio do UM está desmarcada. Este valor é a predefinição.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NotifyEmail

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Pin

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PINExpired

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PINExpired

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SendEmail

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

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.