Stop-DscConfiguration

  • Referência
Módulo:
PSDesiredStateConfiguration

Interrompe um trabalho de configuração em execução.

Syntax

Stop-DscConfiguration
    [-Force]
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O Stop-DscConfiguration cmdlet 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-DscConfigurationsó 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 New-CimSession cmdlet . 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 $Session variável . Quando o comando for executado, você será solicitado a fornecer 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 em versões posteriores do sistema operacional Windows, você deve abrir o PowerShell com a opção Executar como administrador . Para obter mais informações, consulte about_Remote_Requirements.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Stop-DscConfiguration não dá suporte ao parâmetro Confirm . Se o parâmetro Confirm for usado, um erro será exibido.

Para cmdlets do PowerShell que dão suporte a Confirmar, o uso do parâmetro solicita a verificação antes que um comando seja executado.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 limitação ideal com base no número de cmdlets CIM em execução no computador. O limite de aceleração aplica-se somente ao cmdlet atual, e não à sessão ou ao computador.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

None