Stop-DscConfiguration
Detiene un trabajo de configuración que se está ejecutando.
Sintaxis
Stop-DscConfiguration
[-Force]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
El cmdlet Stop-DscConfiguration detiene un trabajo de configuración que se está ejecutando. Especifique a qué equipos 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-DscConfiguration solo 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 de 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 cmdlet New-CimSession. 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 variable $Session. 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 obtener 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, vea about_Remote_Requirements.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | CimSession[] |
| Alias: | Session |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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, con el parámetro se le solicita la comprobación antes de ejecutar un comando.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Force
Obliga a que el comando se ejecute sin pedir confirmación del usuario.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 según el 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 o al equipo.
| Tipo: | Int32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
None
Salidas
None
