Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Descrição curta
Descreve os parâmetros que podem ser usados com qualquer cmdlet.
Descrição longa
Os parâmetros comuns são um conjunto de parâmetros de cmdlet que você pode usar com qualquer cmdlet. Eles são implementados pelo PowerShell, não pelo desenvolvedor do cmdlet e estão automaticamente disponíveis para qualquer cmdlet.
Você pode usar os parâmetros comuns com qualquer cmdlet, mas eles podem não ter um efeito em todos os cmdlets. Por exemplo, se um cmdlet não gerar nenhuma saída detalhada, usar o parâmetro comum Verbose não terá efeito.
Os parâmetros comuns também estão disponíveis em funções avançadas que usam o atributo CmdletBinding ou o atributo Parameter. Quando você usa esses atributos, o PowerShell adiciona automaticamente os Parâmetros Comuns. Não é possível criar parâmetros que usem os mesmos nomes que os Parâmetros Comuns.
Vários parâmetros comuns substituem os padrões ou preferências do sistema definidos usando as variáveis de preferência do PowerShell. Ao contrário das variáveis de preferência, os parâmetros comuns afetam apenas os comandos nos quais são usados.
Para obter mais informações, consulte about_Preference_Variables.
A lista a seguir exibe os parâmetros comuns. Seus aliases são listados entre parênteses.
-
Debug(db) -
ErrorAction(ea) -
ErrorVariable(ev) -
InformationAction(infa) -
InformationVariable(iv) -
OutVariable(ov) -
OutBuffer(ob) -
PipelineVariable(pv) -
ProgressAction(proga) -
Verbose(vb) -
WarningAction(wa) -
WarningVariable(wv)
Os parâmetros de ação são ActionPreference valores de tipo.
ActionPreference é uma enumeração com os seguintes valores:
| Nome | Valor |
|---|---|
Break |
6 |
Suspend |
5 |
Ignore |
4 |
Inquire |
3 |
Continue |
2 |
Stop |
1 |
SilentlyContinue |
0 |
Você pode usar o nome ou o valor com o parâmetro.
Além dos parâmetros comuns, muitos cmdlets oferecem parâmetros de mitigação de risco. Os cmdlets que envolvem o risco para o sistema ou para os dados do usuário geralmente oferecem esses parâmetros.
Os parâmetros de mitigação de risco são:
-
WhatIf(wi) -
Confirm(cf)
Parâmetros comuns
-Debug
Exibe detalhes no nível do programador sobre a operação feita pelo comando. Esse parâmetro funciona somente quando o comando gera uma mensagem de depuração. Por exemplo, esse parâmetro funciona quando um comando contém o cmdlet Write-Debug.
Type: SwitchParameter
Aliases: db
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Por padrão, as mensagens de depuração não são exibidas porque o valor da $DebugPreference variável é SilentlyContinue.
O Debug parâmetro substitui o valor da $DebugPreference variável para o comando atual, definindo o valor como $DebugPreferenceContinue.
-Debug:$true tem o mesmo efeito que -Debug. Use -Debug:$false para suprimir a exibição de mensagens de depuração quando $DebugPreference não SilentlyContinueestiver, que é o padrão.
-ErrorAction
Determina como o cmdlet responde a um erro de não terminação do comando.
Esse parâmetro funciona somente quando o comando gera um erro de não terminação, como aqueles do cmdlet Write-Error.
Type: ActionPreference
Aliases: ea
Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False
O parâmetro ErrorAction substitui o valor da variável $ErrorActionPreference para o comando atual. Como o valor padrão da variável é$ErrorActionPreference, as Continue mensagens de erro são exibidas e a execução continua, a menos que você use o ErrorAction parâmetro.
O ErrorAction parâmetro não tem efeito sobre a conclusão de erros (como dados ausentes, parâmetros que não são válidos ou permissões insuficientes) que impedem que um comando seja concluído com êxito.
-
BreakInsere o depurador quando ocorre um erro ou uma exceção é gerada. -
Continueexibe a mensagem de erro e continua executando o comando.Continueé o padrão. -
Ignoresuprime a mensagem de erro e continua executando o comando. Ao contrárioSilentlyContinuede ,Ignorenão adiciona a mensagem de erro à$Errorvariável automática. OIgnorevalor é introduzido no PowerShell 3.0. -
Inquireexibe a mensagem de erro e solicita confirmação antes de continuar a execução. Esse valor raramente é usado. -
SilentlyContinuesuprime a mensagem de erro e continua executando o comando. -
Stopexibe a mensagem de erro e interrompe a execução do comando. -
Suspendsó está disponível para fluxos de trabalho que não têm suporte no PowerShell 6 e posteriores.
Nota
O ErrorAction parâmetro substitui, mas não substitui o valor da $ErrorActionPreference variável quando o parâmetro é usado em um comando para executar um script ou função.
-ErrorVariable
Os registros de erro são armazenados automaticamente no $Error variável automática. Para obter mais informações, consulte about_Automatic_Variables.
Quando você usa o ErrorVariable parâmetro em um comando, o PowerShell também armazena os registros de erro emitidos pelo comando na variável especificada pelo parâmetro.
Type: String
Aliases: ev
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Por padrão, novas mensagens de erro substituem mensagens de erro que já estão armazenadas na variável. Para acrescentar a mensagem de erro ao conteúdo da variável, coloque um sinal de adição (+) antes do nome da variável.
Por exemplo, o comando a seguir cria a variável $a e armazena todos os erros nele:
Get-Process -Id 6 -ErrorVariable a
O comando a seguir adiciona mensagens de erro à variável $a:
Get-Process -Id 2 -ErrorVariable +a
O comando a seguir exibe o conteúdo de $a:
$a
Você pode usar esse parâmetro para criar uma variável que contém apenas mensagens de erro de comandos específicos e não afeta o comportamento do $Error variável automática. A variável $Error automática contém mensagens de erro de todos os comandos na sessão. Você pode usar a notação de matriz, como $a[0] ou $Error[1,2] para se referir a erros específicos armazenados nas variáveis.
Nota
A variável de erro personalizada contém todos os erros gerados pelo comando, incluindo erros de chamadas a funções aninhadas ou scripts.
-InformationAction
Introduzido no PowerShell 5.0. Dentro do comando ou script no qual ele é usado, o InformationAction parâmetro comum substitui o valor da variável de $InformationPreference preferência, que por padrão é definida como SilentlyContinue. Quando você usa Write-Information em um script com InformationAction, Write-Information os valores são mostrados dependendo do valor do InformationAction parâmetro. Para obter mais informações sobre $InformationPreference, consulte about_Preference_Variables.
Type: ActionPreference
Aliases: infa
Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False
-
Breakinsere o depurador em uma ocorrência do comandoWrite-Information. -
Stopinterrompe um comando ou script em uma ocorrência do comandoWrite-Information. -
Ignoresuprime a mensagem informativa e continua executando o comando. Ao contrárioSilentlyContinuede ,Ignoreesquece completamente a mensagem informativa; ela não adiciona a mensagem informativa ao fluxo de informações. -
Inquireexibe a mensagem informativa especificada em um comandoWrite-Informatione pergunta se deseja continuar. -
Continueexibe a mensagem informativa e continua em execução. -
Suspendnão tem suporte no PowerShell 6 e superior, pois só está disponível para fluxos de trabalho. -
SilentlyContinuenenhum efeito, pois a mensagem informativa não é exibida (Padrão) e o script continua sem interrupção.
Nota
O InformationAction parâmetro substitui, mas não substitui o valor da variável de $InformationAction preferência quando o parâmetro é usado em um comando para executar um script ou função.
-InformationVariable
Introduzido no PowerShell 5.0. Quando você usa o InformationVariable parâmetro comum, os registros de informações são armazenados na variável especificada pelo parâmetro. E o cmdlet do PowerShell pode gravar registros de informações no Information fluxo. Você também pode usar o cmdlet Write-Information para gravar registros de informações.
Os registros de informações são exibidos como mensagens no console por padrão. Você pode controlar a exibição do registro de informações usando o InformationAction parâmetro comum. Você também pode alterar o comportamento usando a variável de preferência $InformationPreference. Para obter mais informações sobre $InformationPreference, consulte about_Preference_Variables.
Nota
A variável de informações contém todas as mensagens de informações geradas pelo comando, incluindo mensagens de informações de chamadas para funções aninhadas ou scripts.
Type: String
Aliases: iv
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Por padrão, novos valores de substituição de registro de informações que já estão armazenados na variável. Para acrescentar a mensagem de erro ao conteúdo da variável, coloque um sinal de adição (+) antes do nome da variável.
-OutBuffer
Determina o número de objetos a serem acumulados em um buffer antes que qualquer objeto seja enviado pelo pipeline. Se você omitir esse parâmetro, os objetos serão enviados conforme eles são gerados.
Type: Int32
Aliases: ob
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Esse parâmetro de gerenciamento de recursos foi projetado para usuários avançados. Quando você usa esse parâmetro, o PowerShell envia dados para o próximo cmdlet em lotes de OutBuffer + 1.
O exemplo a seguir alterna exibe entre ForEach-Object blocos de processo que usam o cmdlet Write-Host. A exibição alterna em lotes de 2 ou OutBuffer + 1.
1..4 | ForEach-Object {
Write-Host "$($_): First"; $_
} -OutBuffer 1 | ForEach-Object {
Write-Host "$($_): Second" }
1: First
2: First
1: Second
2: Second
3: First
4: First
3: Second
4: Second
-OutVariable
Armazena objetos de saída do comando na variável especificada, além de enviar a saída ao longo do pipeline.
Type: String
Aliases: ov
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Para adicionar a saída à variável, em vez de substituir qualquer saída que já possa estar armazenada lá, digite um sinal de adição (+) antes do nome da variável.
Por exemplo, o comando a seguir cria a variável $out e armazena o objeto de processo nele:
Get-Process powershell -OutVariable out
O comando a seguir adiciona o objeto de processo à variável $out:
Get-Process iexplore -OutVariable +out
O comando a seguir exibe o conteúdo da variável $out:
$out
Nota
A variável criada pelo OutVariable parâmetro é um [System.Collections.ArrayList].
-PipelineVariable
PipelineVariable permite o acesso ao valor mais recente passado para o próximo segmento de pipeline pelo comando que usa esse parâmetro. Qualquer comando no pipeline pode acessar o valor usando o nome PipelineVariable. O valor é atribuído à variável quando é passado para o próximo segmento de pipeline. Isso facilita o PipelineVariable uso do que uma variável temporária específica, que pode precisar ser atribuída em vários locais.
Ao contrário $_ ou $PSItem, o uso de um PipelineVariable comando de pipeline permite que qualquer comando de pipeline acesse valores de pipeline passados (e salvos) por comandos diferentes do comando imediatamente anterior. Os comandos de pipeline podem acessar o último valor canalizado durante o processamento do próximo item que passa pelo pipeline. Isso permite que um comando alimente sua saída para um comando anterior (ou a si mesmo).
Nota
As funções avançadas podem ter até três scriptblocks: begin, processe end. Ao usar o PipelineVariable parâmetro com funções avançadas, somente os valores do primeiro scriptblock definido são atribuídos à variável à medida que a função é executada. Para obter mais informações, consulte funções avançadas. O PowerShell 7.2 corrige esse comportamento.
Type: String
Aliases: pv
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Os valores válidos são cadeias de caracteres, o mesmo que para qualquer nome de variável.
Cuidado
O PipelineVariable escopo é para o pipeline no qual ele é invocado.
As variáveis fora do pipeline, que usam o mesmo nome, são desmarcadas antes que o pipeline seja executado. O PipelineVariable escopo fica fora do escopo quando o pipeline é encerrado. Se vários comandos dentro do pipeline especificarem o mesmo PipelineVariable , haverá apenas uma variável compartilhada. Essa variável é atualizada com a saída canalizada mais recente do comando que especifica a variável.
Alguns comandos de bloqueio coletam todos os itens de pipeline antes de produzir qualquer saída, por exemplo Sort-Object ou Select-Object -Last. Qualquer PipelineVariable atribuído em um comando antes desse comando de bloqueio sempre contém o item canalizado final do comando anterior quando usado em um comando após o comando de bloqueio.
O exemplo a seguir ilustra como funciona PipelineVariable . Neste exemplo, cinco números são canalizados para o primeiro ForEach-Object comando. Cada item no pipeline é armazenado na variável de pipeline chamada $Temp.
O Process bloco do primeiro ForEach-Object comando canaliza o item de pipeline para o comando downstream ForEach-Object . O estado das variáveis é exibido em cada etapa.
# Create a variable named $Temp
$Temp = 8
Get-Variable Temp | Format-Table
$InformationPreference = 'Continue'
Write-Information '-------------------------------------------------'
111,222,333,444,555 | ForEach-Object -PipelineVariable Temp -Begin {
# Note that the newly create $Temp variable doesn't contain the value 8
# assigned before the pipeline started and that $PSItem is empty in
# the Begin block.
Write-Information "Upstream (Begin): PSItem = '$PSItem', Temp = '$Temp'"
} -Process {
Write-Information "Upstream (Process): PSItem = '$PSItem', Temp = '$Temp'"
return $PSItem
} | ForEach-Object -Process {
Write-Information "`tDownstream: PSItem = '$PSItem', Temp = '$Temp'"
}
Write-Information '-------------------------------------------------'
# The $Temp variable is deleted when the pipeline finishes
Get-Variable Temp | Format-Table
Name Value
---- -----
Temp 8
-------------------------------------------------
Upstream (Begin): PSItem = '', Temp = ''
Upstream (Process): PSItem = '111', Temp = ''
Downstream: PSItem = '111', Temp = '111'
Upstream (Process): PSItem = '222', Temp = '111'
Downstream: PSItem = '222', Temp = '222'
Upstream (Process): PSItem = '333', Temp = '222'
Downstream: PSItem = '333', Temp = '333'
Upstream (Process): PSItem = '444', Temp = '333'
Downstream: PSItem = '444', Temp = '444'
Upstream (Process): PSItem = '555', Temp = '444'
Downstream: PSItem = '555', Temp = '555'
-------------------------------------------------
Name Value
---- -----
Temp
Cuidado
Há dois problemas conhecidos com o uso do PipelineVariable parâmetro em um pipeline que inclui cimCmdlets ou cmdlets CDXML. Nos exemplos a seguir, Get-Partition é uma função CDXML e Get-CimInstance é um CimCmdlet.
Problema 1: uso de funções [CmdletBinding()]CDXML, que permite o PipelineVariable parâmetro.
Get-Partition -pv pvar
No entanto, quando você usa PipelineVariable no Windows PowerShell v5.1, recebe o seguinte erro.
Get-Partition : Cannot retrieve the dynamic parameters for the cmdlet.
Object reference not set to an instance of an object.
At line:1 char:1
+ get-partition -PipelineVariable pvar
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : InvalidArgument: (:) [Get-Partition], ParameterBindingException
+ FullyQualifiedErrorId : GetDynamicParametersException,Get-Partition
Problema 2: quando o comando anterior não é um comando CDXML e o downstream contém qualquer tipo de comando, o PipelineVariable restante permanece como o último objeto acumulado.
Get-CimInstance Win32_DiskDrive -pv pvar |
ForEach-Object {
Write-Host "Upstream: Disk $($pvar.Index)"
return [pscustomobject]@{ DiskNumber = $_.Index }
} | Get-Partition | ForEach-Object {
Write-Host "Downstream: Disk $($pvar.Index)"
}
Observe que o valor do $pvar conjunto para o último objeto no pipeline para o segundo ForEach-Object comando.
Upstream: Disk 1
Upstream: Disk 2
Upstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0
-ProgressAction
Determina como o PowerShell responde às atualizações de progresso geradas por um script, cmdlet ou provedor, como as barras de progresso geradas pelo cmdlet Write-Progress. O cmdlet Write-Progress cria barras de progresso que mostram o status de um comando. O ProgressAction parâmetro foi adicionado no PowerShell 7.4.
O ProgressAction parâmetro usa um dos valores de ActionPreference enumeração: SilentlyContinue, , Stop, Continue, , Inquire, Ignore, , Suspendou Break.
Os valores válidos são os seguintes:
-
Breakinsere o depurador em uma ocorrência do comandoWrite-Progress. -
Stop: não exibe a barra de progresso. Em vez disso, ele exibe uma mensagem de erro e interrompe a execução. -
Inquire: não exibe a barra de progresso. Solicita permissão para continuar. Se você responder comYouA, ele exibirá a barra de progresso. -
Continue: (Padrão) Exibe a barra de progresso e continua com a execução. -
SilentlyContinue: executa o comando, mas não exibe a barra de progresso.
Type: ActionPreference
Aliases: proga
Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False
-Verbose
Exibe informações detalhadas sobre a operação feita pelo comando. Essas informações se assemelham às informações em um rastreamento ou em um log de transações. Esse parâmetro funciona somente quando o comando gera uma mensagem detalhada. Por exemplo, esse parâmetro funciona quando um comando contém o cmdlet Write-Verbose.
Type: SwitchParameter
Aliases: vb
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
O parâmetro Verbose substitui o valor da variável $VerbosePreference para o comando atual. Como o valor padrão da $VerbosePreference variável é SilentlyContinue, as mensagens detalhadas não são exibidas por padrão.
-
-Verbose:$truetem o mesmo efeito que-Verbose -
-Verbose:$falsesuprime a exibição de mensagens detalhadas. Use esse parâmetro quando o valor$VerbosePreferencenãoSilentlyContinuefor (o padrão).
-WarningAction
Determina como o cmdlet responde a um aviso do comando.
Continue é o valor padrão. Esse parâmetro funciona somente quando o comando gera uma mensagem de aviso. Por exemplo, esse parâmetro funciona quando um comando contém o cmdlet Write-Warning.
Type: ActionPreference
Aliases: wa
Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False
O parâmetro WarningAction substitui o valor da variável $WarningPreference para o comando atual. Como o valor padrão da variável é$WarningPreference, os Continue avisos são exibidos e a execução continua, a menos que você use o WarningAction parâmetro.
-
Breakinsere o depurador quando ocorre um aviso. -
Continueexibe as mensagens de aviso e continua executando o comando.Continueé o padrão. -
Inquireexibe a mensagem de aviso e solicita confirmação antes de continuar a execução. Esse valor raramente é usado. -
SilentlyContinuesuprime a mensagem de aviso e continua executando o comando. -
Stopexibe a mensagem de aviso e interrompe a execução do comando.
Nota
O WarningAction parâmetro substitui, mas não substitui o valor da variável de $WarningAction preferência quando o parâmetro é usado em um comando para executar um script ou função.
-WarningVariable
Armazena registros de aviso sobre o comando na variável especificada.
Type: String
Aliases: wv
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Todos os avisos gerados são salvos na variável mesmo que os avisos não sejam exibidos para o usuário.
Para acrescentar os avisos ao conteúdo da variável, em vez de substituir quaisquer avisos que já possam estar armazenados lá, digite um sinal de adição (+) antes do nome da variável.
Por exemplo, o comando a seguir cria a variável $a e armazena todos os avisos nele:
Get-Process -Id 6 -WarningVariable a
O comando a seguir adiciona avisos à variável $a:
Get-Process -Id 2 -WarningVariable +a
O comando a seguir exibe o conteúdo de $a:
$a
Você pode usar esse parâmetro para criar uma variável que contenha apenas avisos de comandos específicos. Você pode usar a notação de matriz, como $a[0] ou $warning[1,2] para se referir a avisos específicos armazenados na variável.
Nota
A variável de aviso contém todos os avisos gerados pelo comando, incluindo avisos de chamadas para funções aninhadas ou scripts.
Parâmetros de gerenciamento de risco
-WhatIf
Exibe uma mensagem que descreve o efeito do comando, em vez de executar o comando.
Type: SwitchParameter
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
O parâmetro WhatIf substitui o valor da variável $WhatIfPreference para o comando atual. Como o valor padrão da $WhatIfPreference variável é 0 (desabilitado), WhatIf o comportamento não é feito sem o WhatIf parâmetro. Para obter mais informações, consulte about_Preference_Variables.
-
$truetem o mesmo efeito que-WhatIf. -
$falsesuprime o comportamento automático WhatIf que resulta quando o valor da$WhatIfPreferencevariável é 1.
Por exemplo, o seguinte comando usa o parâmetro -WhatIf em um comando Remove-Item:
Remove-Item Date.csv -WhatIf
Em vez de remover o item, o PowerShell lista as operações que ele faria e os itens que seriam afetados. Esse comando produz a seguinte saída:
What if: Performing operation "Remove File" on
Target "C:\ps-test\date.csv".
-Confirm
Solicita confirmação antes de executar o comando.
Type: SwitchParameter
Aliases: cf
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False
O parâmetro Confirm substitui o valor da variável $ConfirmPreference para o comando atual. O valor padrão é true. Para obter mais informações, consulte about_Preference_Variables.
-
$truetem o mesmo efeito que-Confirm. -
$falsesuprime a confirmação automática, que ocorre quando o valor de$ConfirmPreferenceé menor ou igual ao risco estimado do cmdlet.
Por exemplo, o comando a seguir usa o parâmetro Confirm com um comando Remove-Item. Antes de remover o item, o PowerShell lista as operações que faria e os itens que seriam afetados e solicita aprovação.
PS C:\ps-test> Remove-Item tmp*.txt -Confirm
Confirm
Are you sure you want to perform this action?
Performing operation "Remove File" on Target " C:\ps-test\tmp1.txt
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend
[?] Help (default is "Y"):
As opções de resposta Confirm são as seguintes:
| Resposta | Resultado |
|---|---|
Yes (Y) |
Execute a ação. |
Yes to All (A) |
Executar todas as ações e suprimir as Confirm subsequentes |
| consultas para este comando. | |
No (N): |
Não execute a ação. |
No to All (L): |
Não execute nenhuma ação e suprime as ações subsequentes |
| Confirm consultas para este comando. | |
Suspend (S): |
Pause o comando e crie uma sessão temporária. |
Help (?) |
Exiba ajuda para essas opções. |
A Suspend opção coloca o comando em espera e cria uma sessão aninhada temporária na qual você pode trabalhar até estar pronto para escolher uma Confirm opção.
O prompt de comando para a sessão aninhada tem dois conjuntos de caracteres extras (>>) para indicar que é uma operação filho do comando pai original. Você pode executar comandos e scripts na sessão aninhada. Para encerrar a sessão aninhada e retornar às opções de Confirm para o comando original, digite "exit".
No exemplo a seguir, a opção Suspend (S) é usada para interromper um comando temporariamente enquanto o usuário verifica a ajuda de um parâmetro de comando. Depois de obter as informações necessárias, o usuário digita "sair" para encerrar o prompt aninhado e seleciona a resposta Sim (y) para a consulta Confirm.
PS C:\ps-test> New-Item -ItemType File -Name Test.txt -Confirm
Confirm
Are you sure you want to perform this action?
Performing operation "Create File" on Target "Destination:
C:\ps-test\test.txt".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default
is "Y"): s
PS C:\ps-test> Get-Help New-Item -Parameter ItemType
-ItemType <string>
Specifies the provider-specified type of the new item.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
PS C:\ps-test> exit
Confirm
Are you sure you want to perform this action?
Performing operation "Create File" on Target "Destination: C:\ps-test\test
.txt".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (defau
lt is "Y"): y
Directory: C:\ps-test
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 8/27/2010 2:41 PM 0 test.txt