Parâmetros WhatIf, Confirm e ValidateOnly

  • Artigo

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Tópico modificado em: 2007-06-19

O Shell de Gerenciamento do Exchange é uma interface de gerenciamento muito poderosa e flexível. Você pode gerenciar sua infra-estrutura de modo interativo, na linha de comando. Você pode criar e executar scripts que automatizam tarefas complexas ou usadas freqüentemente. Ao aprender a usar o Shell de Gerenciamento do Exchange por si só, com scripts, ou os dois, convém exibir os resultados de um comando antes que ele afete os dados. Além disso, é conveniente confirmar que um comando está prestes a ser executado. Essa funcionalidade é importante principamente durante a transição do ambiente de teste para o ambiente de produção e à medida que você realiza novos scripts ou comandos.

Os administradores e criadores de script experientes, e administradores iniciantes no Exchange e em scripts podem se beneficiar com o uso dos parâmetros WhatIf, Confirm e Validate. Esses parâmetros estão disponíveis no Shell de Gerenciamento do Exchange. Esses parâmetros permitem controlar a execução de seus comandos e indicam exatamente o que um comando irá fazer antes de afetar dados. Os parâmetros WhatIf, Confirm e Validate são úteis principalmente quando você os utiliza juntamente com comandos que modificam objetos retornados com o uso de um filtro ou um comando Get em um pipeline. Este tópico descreve cada parâmetro.

Importante

Para usar os parâmetros WhatIf, Confirm e ValidateOnly com comandos em um script, adicione o parâmetro adequado a cada comando do script e não na linha de comando que chama o script.

Dica

Os parâmetros WhatIf, Confirm e ValidateOnly são chamados de parâmetros de opção. Para obter mais informações sobre parâmetro de opção, consulte Parâmetros.

Parâmetro WhatIf

O parâmetro WhatIf instrui o comando ao qual é aplicado a executar, mas apenas para exibir os objetos afetados pela execução do comando e as alterações feitas nesses objetos. O domínio não altera realmente nenhum desses objetos. Ao usar o parâmetro WhatIf, você pode verificar se as alterações que seriam feitas nesses objetos corresponderiam às expectativas, sem se preocupar com a modificação desses objetos.

Ao executar um comando junto com o parâmetro WhatIf, coloque o parâmetro WhatIf no final do comando, como no exemplo a seguir:

New-AcceptedDomain -Name "Contoso Domain" -DomainName "contoso.com" -WhatIf

Quando você executar esse comando do exemplo, o Shell de Gerenciamento do Exchange retornará o seguinte texto:

What if: Creating Accepted Domain "Contoso Domain" with Domain Name "contoso.com".

Para exibir uma lista de cmdlets que aceitam o parâmetro WhatIf, digite o seguinte comando no Shell de Gerenciamento do Exchange:

Get-ExCommand | Where { $_.Definition -Like "*WhatIf*" }

Parâmetro Confirm

O parâmetro Confirm instrui o comando ao qual é aplicado a interromper o processamento antes de fazer qualquer alteração. O comando, então, solicita que você confirme cada ação antes de prosseguir. Ao usar o parâmetro Confirm, você poderá consultar as alterações nos objetos para certificar-se de que estão sendo feitas somente nos objetos específicos a serem alterados. Essa funcionalidade é útil quando você aplica alterações a muitos objetos e deseja ter um controle preciso sobre a operação do Shell de Gerenciamento do Exchange. Um prompt de confirmação é exibido para cada objeto antes de o Shell de Gerenciamento do Exchange modificá-lo.

Por padrão, o Shell de Gerenciamento do Exchange aplica automaticamente o parâmetro Confirm a cmdlets que têm os seguintes verbos:

  • Remove

  • Move

  • Stop

  • Clear

  • Suspend

  • Uninstall

  • Dismount

  • Disable

Quando um cmdlet que contém um desses verbos for executado, o Shell de Gerenciamento do Exchange interromperá automaticamente o comando e aguardará sua confirmação antes de continuar o processo.

Ao aplicar manualmente o parâmetro Confirm a um comando, inclua o parâmetro Confirm no final do comando, como no exemplo a seguir:

Get-JournalRule | Enable-JournalRule -Confirm

Quando você executar esse comando do exemplo, o Shell de Gerenciamento do Exchange retornará o seguinte prompt de confirmação:

[Y] Yes   [A] Yes to All   [N] No   [L] No to All   [S] Suspend   [?] Help   
(default is "Y"):

O prompt de confirmação oferece as seguintes opções:

  • [Y] Sim   Digite Y para instruir o comando a continuar a operação. A operação seguinte irá exibir outro prompt de confirmação. [Y] Yes é a opção padrão.

  • [A] Sim para Todos   Digite A para instruir o comando a prosseguir a operação e todas as operações subseqüentes. Você não receberá outros prompts de confirmação durante a execução desse comando.

  • [N] Não   Digite N para instruir o comando a ignorar essa operação e continuar a operação seguinte. A operação seguinte irá exibir outros prompts de confirmação.

  • [L] Não para Todos   Digite L para instruir o comando a ignorar essa operação e todas as operações subseqüentes.

  • [S] Suspender   Digite S para interromper o pipeline atual e retornar para a linha de comando. Digite Sair para retomar o pipeline.

  • [?] Ajuda   Digite ? para exibir a Ajuda do prompt de confirmação na linha de comando.

Para substituir o comportamento padrão do Shell de Gerenciamento do Exchange e suprimir o prompt de confirmação dos cmdlets aos quais estiver aplicado automaticamente, você poderá incluir o parâmetro Confirm com o valor $False, como no exemplo a seguir:

Get-JournalRule | Disable-JournalRule -Confirm:$False

Neste caso, nenhum prompt de confirmação será exibido.

Aviso

O valor padrão do parâmetro Confirm é $True. O comportamento padrão do Shell de Gerenciamento do Exchange é exibir automaticamente um prompt de confirmação. Se você suprimir esse comportamento padrão do Shell de Gerenciamento do Exchange, instruirá o comando a suprimir todos os prompts de confirmação durante a sua execução. O comando processará todos os objetos que atenderem aos respectivos critérios, sem confirmação.

Para exibir uma lista de cmdlets que aceitam o parâmetro Confirm, digite o seguinte comando no Shell de Gerenciamento do Exchange:

Get-ExCommand | Where { $_.Definition -Like "*Confirm*" }

Parâmetro ValidateOnly

O parâmetro ValidateOnly instrui o comando ao qual ele é aplicado a avaliar todas as condições e requisitos necessários para executar a operação antes de você efetuar quaisquer alterações. O parâmetro ValidateOnly está disponível em cmdlets que podem demorar para serem executados, ter dependências em vários sistemas ou afetar dados importantes, como caixas de correio.

Quando você aplica o parâmetro ValidateOnly a um comando, esse comando é executado ao longo de todo o processo. O comando executa cada ação da mesma forma que faria sem o parâmetro ValidateOnly. Porém, o comando não altera nenhum objeto. Quando o comando termina seu processo, exibe um resumo com os resultados da validação. Se a validação indicar que o comando foi bem-sucedido, você poderá executá-lo novamente sem o parâmetro ValidateOnly.

Ao executar um comando juntamente com o parâmetro ValidateOnly, coloque o parâmetro ValidateOnly no final do comando, como no exemplo a seguir:

Get-Mailbox "Kim Akers" | Move-Mailbox -TargetDatabase "Executive Database" -ValidateOnly

Quando você executar esse comando do exemplo, o Shell de Gerenciamento do Exchange retornará o seguinte texto:

Identity                         : contoso.com/Users/Kim Akers
DistinguishedName                : CN=Kim Akers,CN=Users,DC=contoso,DC=com
DisplayName                      : Kim Akers
Alias                            : kim
LegacyExchangeDN                 : /o=First Organization/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=kim
PrimarySmtpAddress               : kim@contoso.com
SourceServer                     : Win2003MS.contoso.com
SourceDatabase                   : WIN2003MS\First Storage Group\Mailbox Database
SourceGlobalCatalog              : Win2003MS.contoso.com
TargetGlobalCatalog              : Win2003MS.contoso.com
TargetDomainController           : Win2003MS.contoso.com
TargetMailbox                    :
TargetServer                     : Win2003MS.contoso.com
TargetDatabase                   : WIN2003MS\Second Storage Group\Executive Database
MailboxSize                      : 0KB
IsResourceMailbox                : False
SIDUsedInMatch                   :
SMTPProxies                      :
SourceManager                    :
SourceDirectReports              :
SourcePublicDelegates            :
SourcePublicDelegatesBL          :
MatchedTargetNTAccountDN         :
IsMatchedNTAccountMailboxEnabled :
MatchedContactsDNList            :
TargetNTAccountDNToCreate        :
TargetManager                    :
TargetDirectReports              :
TargetPublicDelegates            :
TargetPublicDelegatesBL          :
Options                          : Default
SourceForestCredential           :
TargetForestCredential           :
TargetFolder                     :
RsgMailboxGuid                   :
RsgMailboxLegacyExchangeDN       :
RsgMailboxDisplayName            :
RsgDatabaseGuid                  :
MoveType                         : IntraOrg
MoveStage                        : Validation
StartTime                        : 7/17/2006 4:39:13 PM
EndTime                          : 7/17/2006 4:39:14 PM
StatusCode                       : 0
StatusMessage                    : This mailbox can be moved to the target database.

Para exibir uma lista de cmdlets que aceitam o parâmetro ValidateOnly, digite o seguinte comando no Shell de Gerenciamento do Exchange:

Get-ExCommand | Where { $_.Definition -Like "*ValidateOnly*" }