Stop-DscConfiguration
Interrompe um trabalho de configuração que está em execução.
Sintaxe
All
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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Sessão |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Force
Força o comando a ser executado sem pedir a confirmação do usuário.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | Int32 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
