Remove-WssComputer
Remove-WssComputer
Removes a client computer identity, backup, and properties from the network.
Sintaxis
Parameter Set: Default
Remove-WssComputer [-Computer] <DeviceInfo> [-RemoveBackup] [-Confirm] [-WhatIf] [ <CommonParameters>]
Descripción detallada
The Remove-WssComputer cmdlet removes a client computer identity, backup, and properties from the network. For active clients, the cmdlet removes the computer identity, but does not remove backups, unless you use the RemoveBackup parameter to remove associated backups.
An archived client exists only as a backup of a computer that is no longer part of the network. This cmdlet removes the identity, backup, and properties for an archived client without the RemoveBackup parameter.
Parámetros
-Computer<DeviceInfo>
Specifies the DeviceInfo object for computer. To obtain DeviceInfo objects, use the Get-WssComputer cmdlet.
Alias |
ninguno |
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByValue) |
¿Aceptar caracteres comodín? |
false |
-RemoveBackup
Indicates that the cmdlet removes any backups for the specified computer.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el cmdlet.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
falso |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
falso |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entradas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.
Salidas
El tipo de resultado es el tipo de objetos que emite el cmdlet.
Ejemplos
Example 1: Remove a computer and backups
This example removes a computer identity and any backups from the network.
The first command uses the Get-WssComputer cmdlet to get all DeviceInfo objects, and then stores them in the $DeviceList variable.
The second command removes a DeviceInfo object. The command uses standard array notation to specify the first element of the $DeviceList array as the computer to be removed. The command includes the RemoveBackup parameter. Therefore, the command removes any backups.
PS C:\> $DeviceList = Get-WssComputer
PS C:\> Remove-WssComputer -Computer $DeviceList[0] -RemoveBackup