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.