Stop-DscConfiguration

  • Referência
Módulo:
PSDesiredStateConfiguration

Para uma tarefa de configuração em execução.

Syntax

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

Description

O Stop-DscConfiguration cmdlet para uma tarefa de configuração em execução. Especifique a que computadores este cmdlet se aplica através de sessões cim (Common Information Model). Se não existir nenhuma tarefa de configuração em execução, este cmdlet devolve uma mensagem de aviso.

Stop-DscConfigurationsó está disponível como parte do update rollup 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 utilizar este cmdlet, reveja as informações em Novidades no Windows PowerShell 5.0

Exemplos

Exemplo 1: Parar uma tarefa de configuração

Neste exemplo, é criada uma sessão CIM com o New-CimSession cmdlet . O objeto CimSession é utilizado para parar uma tarefa de configuração em execução.

$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session

New-CimSession utiliza o parâmetro ComputerName para especificar o computador Server01. O parâmetro Credential especifica a conta de utilizador. O objeto CimSession é armazenado na $Session variável . Quando o comando é executado, ser-lhe-á pedida a palavra-passe da conta de utilizador.

Stop-DscConfiguration utiliza o parâmetro CimSession e o objeto armazenado no $Session para parar a tarefa de configuração.

Parâmetros

-AsJob

Indica que este cmdlet executa o comando como uma tarefa em segundo plano. Para obter mais informações sobre as tarefas em segundo plano do PowerShell, veja about_Jobs e about_Remote_Jobs.

Para utilizar o parâmetro AsJob , os computadores locais e remotos têm de ser configurados para comunicação remota. No Windows Vista e versões posteriores do sistema operativo Windows, tem de abrir o PowerShell com a opção Executar como administrador . Para obter mais informações, veja about_Remote_Requirements.

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

-CimSession

Executa o cmdlet numa sessão remota ou num computador remoto. Introduza um nome de computador ou um objeto de sessão, como o resultado 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 suporta o parâmetro Confirmar . Se o parâmetro Confirmar for utilizado, é apresentado um erro.

Para cmdlets do PowerShell que suportam Confirmar, a utilização do parâmetro pede-lhe a verificação antes de um comando ser 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 pedir a confirmação do utilizador.

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 este parâmetro for omitido ou for introduzido um valor de 0 , o PowerShell calcula um limite de limitação ideal com base no número de cmdlets CIM que estão em execução no computador. O limite de limitação aplica-se apenas ao cmdlet atual, 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

Apresenta o que aconteceria mediante a execução do cmdlet. 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