Remove-CsTrustedApplicationComputer
Última modificación del tema: 2012-03-26
Quita un equipo de la aplicación de confianza.
Sintaxis
Remove-CsTrustedApplicationComputer -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Se recomienda que los equipos que ejecutan las aplicaciones de confianza en una instalación de Microsoft Lync Server 2010 se agreguen a un grupo de servidores independiente utilizado únicamente para aplicaciones de confianza. No obstante, se pueden agregar equipos de aplicaciones de confianza a un grupo de servidores existente que también se utiliza con otros fines. Use este cmdlet para quitar un equipo de una aplicación de confianza.
Si usa este cmdlet para quitar un equipo de una aplicación de confianza, no solo se quitará de la lista de equipos de la aplicación de confianza sino también de la lista de equipos disponibles en Lync Server 2010. En otras palabras, si llama a Get-CsTrustedApplicationComputer o a Get-CsComputer el equipo dejará de aparecer en la lista. No es posible quitar un equipo de una aplicación de confianza, si se trata del único equipo del grupo. Si desea quitar el único equipo de un grupo, deberá quitar el grupo entero (para ello, llame a Remove-CsTrustedApplicationPool).
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-CsTrustedApplicationComputer de forma local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTrustedApplicationComputer"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
XdsGlobalRelativeIdentity |
El nombre de dominio completo (FQDN) del equipo que se va a quitar. |
Force |
Opcional |
Parámetro modificador |
Suprime los mensajes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Objeto Microsoft.Rtc.Management.Xds.DisplayComputer. Acepta la entrada transferida de objetos de equipos de aplicaciones de confianza.
Tipos de valores devueltos
Este cmdlet no devuelve un valor. Quita un objeto de tipo Microsoft.Rtc.Management.Xds.DisplayComputer.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Remove-CsTrustedApplicationComputer -Identity Trust1.litwareinc.com
En este ejemplo se quita el equipo con el FQDN Trust1.litwareinc.com.
-------------------------- Ejemplo 2 ------------------------
Get-CsTrustedApplicationComputer -Filter Trust* | Remove-CsTrustedApplicationComputer
En este ejemplo se quitan todos los equipos de confianza con un FQDN que comience por la cadena de caracteres Trust. El ejemplo comienza con una llamada al cmdlet Get-CsTrustedApplicationComputer mediante el cual se transfiere al parámetro Filter el valor Trust*. De este modo, se recuperan todos los equipos de la aplicación de confianza con un FQDN que comience por Trust y que acabe con cualquier conjunto de caracteres. A continuación, la colección de equipos se transfiere al cmdlet Remove-CsTrustedApplicationComputer que quita todos los elementos (equipos) de la colección. Tenga en cuenta que los equipos no se quitarán del grupo, si esto diera como resultado un grupo vacío.