Remove-CsTrustedApplicationPool

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt einen Pool von Computern, auf denen vertrauenswürdige Anwendungen gehostet werden.

Syntax

Remove-CsTrustedApplicationPool -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Es wird empfohlen, Computer, auf denen innerhalb einer Microsoft Lync Server 2010-Bereitstellung vertrauenswürdige Anwendungen ausgeführt werden, einem separaten Pool nur für vertrauenswürdige Anwendungen hinzuzufügen. Sie können Computer mit vertrauenswürdigen Anwendungen auch einem vorhandenen Pool hinzufügen, der bereits für andere Zwecke genutzt wird. Dieses Cmdlet entfernt einen vorhandenen vertrauenswürdigen Anwendungspool. Vertrauenswürdige Anwendungspools ohne Wert für "Registrar" können jedoch nicht entfernt werden. Wenn dem vertrauenswürdigen Anwendungspool keine Registrierung zugewiesen wurde, müssen Sie mit dem Cmdlet Set-CsTrustedApplicationPool einen Wert für "Registrar" hinzufügen und den Pool anschließend entfernen.

Beachten Sie, dass durch das Entfernen des Pools auch alle dem Pool zugeordneten Computer, Anwendungen und Anwendungsendpunkte entfernt werden.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsTrustedApplicationPool lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTrustedApplicationPool"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) oder die Dienst-ID des Pools, den Sie entfernen möchten.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Management.Xds.DisplayExternalServer-Objekt. Akzeptiert eine weitergeleitete Eingabe von Objekten für Pools mit vertrauenswürdigen Anwendungen.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück. Mit ihm wird ein Objekt vom Typ "Microsoft.Rtc.Management.Xds.DisplayExternalServer" entfernt.

Beispiel

-------------------------- Beispiel 1 ------------------------

Remove-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com

In diesem Beispiel wird der Pool mit dem FQDN "TrustPool.litwareinc.com" entfernt. Mit dem Parameter "Identity" wird der FQDN des Pools festgelegt, der entfernt werden soll. Da Identitäten eindeutig sein müssen, wird über diesen Befehl maximal ein Pool entfernt.

-------------------------- Beispiel 2 ------------------------

Get-CsTrustedApplicationPool | Where-Object {$_.PoolFqdn -match "trust*"} | Remove-CsTrustedApplicationPool

In diesem Beispiel werden alle vertrauenswürdigen Pools entfernt, deren FQDN mit der Zeichenfolge "trust*" beginnt. Im ersten Teil des Befehls wird das Cmdlet Get-CsTrustedApplicationPool aufgerufen, mit dem eine Auflistung aller vertrauenswürdigen Anwendungspools abgerufen wird, die sich in der Lync Server 2010-Infrastruktur befinden. Diese Auflistung wird an das Cmdlet Where-Object weitergeleitet. Das Cmdlet Where-Object überprüft jedes Element in der Auflistung daraufhin, ob der Wert für "PoolFqdn" mit der Platzhalterzeichenfolge "trust*" übereinstimmt. Dies führt zu einer Auflistung aller vertrauenswürdigen Anwendungspools, bei denen der Pool-FQDN mit der Zeichenfolge "trust" beginnt und beliebige weitere Zeichen enthält. Diese Auflistung wird anschließend an das Cmdlet Remove-CsTrustedApplicationPool weitergeleitet, das alle Elemente in der Auflistung entfernt.