Complete-Transaction
Confirma a transação ativa.
Sintaxe
Default (Default)
Complete-Transaction
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Complete-Transaction confirma uma transação ativa. Quando você confirma uma transação, os comandos na transação são finalizados e os dados afetados pelos comandos são alterados.
Se a transação incluir vários assinantes, para confirmar a transação, você deverá inserir um comando Complete-Transaction para cada comando Start-Transaction.
O cmdlet Complete-Transaction é um de um conjunto de cmdlets que dão suporte ao recurso de transações no Windows PowerShell.
Para obter mais informações, consulte about_Transactions.
Exemplos
Exemplo 1: Confirmar uma transação
Set-Location HKCU:\software
Start-Transaction
New-Item MyCompany -UseTransaction
Get-ChildItem m*
Hive: HKEY_CURRENT_USER\software
SKC VC Name Property
--- -- ---- --------
82 1 Microsoft {(default)}
Complete-Transaction
Get-ChildItem m*
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
82 1 Microsoft {(default)}
0 0 MyCompany {}
Este exemplo mostra o que acontece quando você usa o cmdlet Complete-Transaction para confirmar uma transação.
O comando Start-Transaction inicia a transação. O comando New-Item usa o parâmetro UseTransaction para incluir o comando na transação.
O primeiro comando Get-ChildItem mostra que o novo item ainda não foi adicionado ao registro.
O comando Complete-Transaction confirma a transação, o que torna a alteração do Registro eficaz. Como resultado, o segundo comando Get-ChildItem mostra que o registro foi alterado.
Exemplo 2: Confirmar uma transação que tenha mais de um assinante
Set-Location HKCU:\software
Start-Transaction
New-Item MyCompany -UseTransaction
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
0 0 MyCompany {}
Start-Transaction
Get-Transaction
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 2 Active
New-ItemProperty -Path MyCompany -Name MyKey -Value -UseTransaction
MyKey
-----
123
Complete-Transaction
Get-Transaction
RollbackPreference SubscriberCount Status
------------------ --------------- ------
Error 1 Active
Get-ChildItem m*
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
82 1 Microsoft {(default)}
Complete-Transaction
Get-ChildItem m*
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
82 1 Microsoft {(default)}
0 1 MyCompany {MyKey}
Este exemplo mostra como usar Complete-Transaction para confirmar uma transação com mais de um assinante.
Para confirmar uma transação de vários assinantes, insira um comando Complete-Transaction para cada comando Start-Transaction. Os dados são alterados somente quando o comando Complete-Transaction final é enviado.
Para fins de demonstração, este exemplo mostra uma série de comandos inseridos na linha de comando. Na prática, é provável que as transações sejam executadas em scripts, com a transação secundária sendo executada por uma função ou script auxiliar que é chamado pelo script principal.
Neste exemplo, um comando Start-Transaction inicia a transação. Um comando New-Item com o parâmetro UseTransaction adiciona a chave MyCompany à chave de software. Embora o cmdlet New-Item retorne um objeto de chave, os dados no registro ainda não foram alterados.
Um segundo comando Start-Transaction adiciona um segundo assinante à transação existente. O cmdlet Get-Transaction confirma que a contagem de assinantes é 2. Um comando New-ItemProperty com o parâmetro UseTransaction adiciona uma entrada de registro à nova chave MyCompany. Novamente, o comando retorna um valor, mas o registro não é alterado.
O primeiro comando Complete-Transaction reduz a contagem de assinantes em 1. Isso é confirmado por um comando Get-Transaction. No entanto, nenhum dado é alterado, conforme evidenciado por um comando Get-ChildItem m*.
O segundo comando Complete-Transaction confirma toda a transação e altera os dados no registro. Isso é confirmado por um segundo comando Get-ChildItem m*, que mostra as alterações.
Exemplo 3: executar uma transação que não altera nenhum dado
Set-Location HKCU:\software
Start-Transaction
New-Item MyCompany -UseTransaction
Get-ChildItem m*
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
82 1 Microsoft {(default)}
Get-ChildItem m* -UseTransaction
Hive: HKEY_CURRENT_USER\Software
SKC VC Name Property
--- -- ---- --------
82 1 Microsoft {(default)}
0 0 MyCompany {}
Complete-Transaction
Este exemplo mostra o valor do uso de comandos Get-* e outros comandos que não alteram dados em uma transação. Quando um comando Get-\* é usado em uma transação, ele obtém os objetos que fazem parte da transação. Isso permite que você visualize as alterações na transação antes que as alterações sejam confirmadas.
Neste exemplo, uma transação é iniciada. Um comando New-Item com o parâmetro UseTransaction adiciona uma nova chave ao registro como parte da transação.
Como a nova chave do Registro não é adicionada ao registro até que o comando Complete-Transaction seja executado, um comando Get-ChildItem simples mostra o registro sem a nova chave.
No entanto, quando você adiciona o parâmetro UseTransaction ao comando Get-ChildItem, o comando se torna parte da transação e obtém os itens na transação mesmo que ainda não sejam adicionados aos dados.
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| 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 |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| 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, consulte about_CommonParameters.
Entradas
None
Você não pode redirecionar objetos para este cmdlet.
Saídas
None
Esse cmdlet não gera nenhuma saída.
Observações
Você não pode reverter uma transação confirmada ou confirmar uma transação que foi revertida.
Você não pode reverter qualquer transação que não seja a transação ativa. Para reverter uma transação diferente, primeiro você deve confirmar ou reverter a transação ativa.
Por padrão, se qualquer parte de uma transação não puder ser confirmada, como quando um comando na transação resultar em um erro, toda a transação será revertida.
