Stop-DscConfiguration
Interrompe um trabalho de configuração 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 de 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 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 de Credenciais
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. Para obter mais informações, confira about_Remote_Requirements.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 |
-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 do parâmetro
| Tipo: | |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Session |
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 |
-Confirm
Stop-DscConfiguration não dá suporte ao parâmetro Confirm. Se o parâmetro Confirmar for usado, um erro será exibido.
Para cmdlets do PowerShell que dão suporte a Confirme, o uso do parâmetro solicita a verificação antes de um comando ser executado.
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 |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 |
-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 ideal com base no número de cmdlets CIM em execução no computador. O limite de limitação se aplica somente ao cmdlet atual, não à sessão ou ao computador.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
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.
