Stop-DscConfiguration
Interrompe um trabalho de configuração que está em execução.
Sintaxe
Stop-DscConfiguration
[-Force]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O cmdlet Stop-DscConfiguration interrompe um trabalho de configuração em execução. Especifique a quais computadores esse cmdlet se aplica usando sessões do CIM (Common Information Model). Se não houver nenhum trabalho de configuração em execução, esse cmdlet retornará uma mensagem de aviso.
Stop-DscConfiguration só está disponível como parte do pacote cumulativo de atualizações de de novembro de 2014 para Windows RT 8.1, Windows 8.1 e Windows Server 2012 R2 da biblioteca de Suporte da Microsoft. Antes de usar esse cmdlet, examine as informações em Novidades no Windows PowerShell 5.0
Exemplos
Exemplo 1: Parar um trabalho de configuração
Neste exemplo, uma sessão CIM é criada usando o cmdlet New-CimSession. O objeto CimSession é usado para interromper um trabalho de configuração em execução.
$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session
New-CimSession usa o parâmetro ComputerName para especificar o computador Server01. O parâmetro Credential especifica a conta de usuário. O objeto CimSession é armazenado na variável $Session. Quando o comando é executado, é solicitada a senha da conta de usuário.
Stop-DscConfiguration usa o parâmetro CimSession e o objeto armazenado em $Session para interromper o trabalho de configuração.
Parâmetros
-AsJob
Indica que esse cmdlet executa o comando como um trabalho em segundo plano. Para obter mais informações sobre trabalhos em segundo plano do PowerShell, consulte about_Jobs e about_Remote_Jobs.
Para usar o parâmetro AsJob, os computadores locais e remotos devem ser configurados para comunicação remota. No Windows Vista e versões posteriores do sistema operacional Windows, você deve abrir o PowerShell com a opção Executar como administrador opção. Para obter mais informações, consulte about_Remote_Requirements.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-CimSession
Executa o cmdlet em uma sessão remota ou em um computador remoto. Insira um nome de computador ou um objeto de sessão, como a saída de New-CimSession ou Get-CimSession.
| Tipo: | CimSession[] |
| Aliases: | Session |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Confirm
Stop-DscConfiguration não suporta o parâmetro Confirm. Se o parâmetro Confirm for usado, um erro será exibido.
Para cmdlets do PowerShell que oferecem suporte a Confirmar, o uso do parâmetro solicita a verificação antes da execução de um comando.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Force
Força o comando a ser executado sem pedir a confirmação do usuário.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ThrottleLimit
Especifica o número máximo de operações simultâneas que podem ser estabelecidas para executar o cmdlet.
Se esse parâmetro for omitido ou um valor de 0 for inserido, o PowerShell calculará um limite de aceleração ideal com base no número de cmdlets CIM em execução no computador. O limite de aceleração aplica-se apenas ao cmdlet atual, não à sessão ou ao computador.
| Tipo: | Int32 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
Entradas
None
Saídas
None
