Stop-DscConfiguration

  • Referencia
Módulo:
PSDesiredStateConfiguration

Detiene un trabajo de configuración que se está ejecutando.

Syntax

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

Description

El Stop-DscConfiguration cmdlet detiene un trabajo de configuración que se está ejecutando. Especifique los equipos a los que se aplica este cmdlet mediante sesiones de Common Information Model (CIM). Si no hay ningún trabajo de configuración en ejecución, este cmdlet devuelve un mensaje de advertencia.

Stop-DscConfigurationsolo está disponible como parte del paquete acumulativo de actualizaciones de noviembre de 2014 para Windows RT 8.1, Windows 8.1 y Windows Server 2012 R2 desde la biblioteca de Soporte técnico de Microsoft. Antes de usar este cmdlet, revise la información de Novedades de Windows PowerShell 5.0.

Ejemplos

Ejemplo 1: Detener un trabajo de configuración

En este ejemplo, se crea una sesión CIM mediante el New-CimSession cmdlet . El objeto CimSession se usa para detener un trabajo de configuración en ejecución.

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

New-CimSession usa el parámetro ComputerName para especificar el equipo Server01. El parámetro Credential especifica la cuenta de usuario. El objeto CimSession se almacena en la $Session variable . Cuando se ejecuta el comando, se le pedirá la contraseña de la cuenta de usuario.

Stop-DscConfiguration usa el parámetro CimSession y el objeto almacenado en $Session para detener el trabajo de configuración.

Parámetros

-AsJob

Indica que este cmdlet ejecuta el comando como un trabajo en segundo plano. Para más información sobre los trabajos en segundo plano de PowerShell, consulte about_Jobs y about_Remote_Jobs.

Para usar el parámetro AsJob , los equipos locales y remotos deben configurarse para la comunicación remota. En Windows Vista y versiones posteriores del sistema operativo Windows, debe abrir PowerShell con la opción Ejecutar como administrador . Para obtener más información, consulte about_Remote_Requirements.

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

-CimSession

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de New-CimSession o Get-CimSession.

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

-Confirm

Stop-DscConfiguration no admite el parámetro Confirm . Si se usa el parámetro Confirm , se muestra un error.

En el caso de los cmdlets de PowerShell que admiten Confirm, el uso del parámetro le solicita la comprobación antes de ejecutar un comando.

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

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

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

-ThrottleLimit

Especifica el número máximo de operaciones simultáneas que se pueden establecer para ejecutar el cmdlet.

Si se omite este parámetro o se especifica un valor de 0 , PowerShell calcula un límite óptimo en función del número de cmdlets CIM que se ejecutan en el equipo. El límite solo se aplica al cmdlet actual, no a la sesión ni al equipo.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

None

Salidas

None