• Artikel

Remove-CsTrustedApplicationEndpoint

 

Letztes Änderungsdatum des Themas: 2012-03-26

Entfernt einen vertrauenswürdigen Anwendungsendpunkt.

Syntax

Remove-CsTrustedApplicationEndpoint -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Ein vertrauenswürdiger Anwendungsendpunkt ist ein Active Directory-Kontaktobjekt, mit dem Anrufe an eine vertrauenswürdige Anwendung weitergeleitet werden können. Dieses Cmdlet entfernt ein vorhandenes Endpunktkontaktobjekt aus Active Directory-Domänendienste (AD DS).

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsTrustedApplicationEndpoint 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-CsTrustedApplicationEndpoint"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

UserIdParameter

Der Identitätswert (der Distinguished Name des Kontakts), die SIP-Adresse oder der Anzeigenamen des Anwendungspunkts, der bzw. die entfernt werden soll.

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.ADConnect.Schema.OCSADApplicationContact-Objekt. Akzeptiert eine weitergeleitete Eingabe von vertrauenswürdigen Anwendungsendpunktobjekten.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück. Entfernt ein Objekt vom Typ Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Beispiel

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

Remove-CsTrustedApplicationEndpoint -Identity "Endpoint 1"

In diesem Beispiel wird der Endpunktkontakt mit der Identität (in diesem Fall dem Anzeigenamen) "Endpoint 1" entfernt. Da Identitäten eindeutig sein müssen, wird mit diesem Befehl maximal ein Endpunkt entfernt.

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

Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Remove-CsTrustedApplicationEndpoint

In diesem Beispiel werden alle vertrauenswürdigen Anwendungsendpunkte entfernt, die der Anwendung "tapp2" zugeordnet sind. Dazu wird zunächst Get-CsTrustedApplicationEndpoint aufgerufen und die ID "tapp2" an den Parameter "ApplicationId" übergeben. Daraufhin wird eine Auflistung der Endpunkte zurückgegeben, die der vertrauenswürdigen Anwendung "tapp2" zugeordnet sind. Diese Auflistung wird dann an das Cmdlet Remove-CsTrustedApplicationEndpoint weitergeleitet, das sämtliche Endpunkte in der Auflistung entfernt. Beachten Sie, dass durch einen Aufruf von Get-CsTrustedApplicationEndpoint Endpunkte mit der Anwendungs-ID "tapp2" aus mehreren Pools abgerufen werden, sodass mit diesem Befehl u. U. vertrauenswürdige Anwendungsendpunkte aus mehreren Pools entfernt werden.