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.
Sintaxe
Default (Default)
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 é bloqueado em uma caixa de correio porque o usuário tentou fazer logon usando um PIN incorreto várias vezes ou porque o usuário esqueceu o 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. Você pode controlar se o usuário deve redefinir o PIN no logon 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, 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 entrar.
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
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. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer 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 usuário
- 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
A opção IgnoreDefaultScope informa ao comando para ignorar a configuração de escopo de destinatário padrão para a sessão do PowerShell do Exchange e usar toda a floresta como 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.
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 de UM. Os valores válidos são:
- $true: A caixa de correio está bloqueada de UM.
- $false: O status bloqueado na caixa de correio de UM está limpo. Esse valor é o padrã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 mostra o que o comando faz sem fazer nenhuma alteração. 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 dá suporte aos 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.