• Artikel

Set-CsTrustedApplicationEndpoint

 

Letztes Änderungsdatum des Themas: 2012-03-25

Ändert einen vorhandenen Endpunktkontakt für eine vertrauenswürdige Anwendung.

Syntax

Set-CsTrustedApplicationEndpoint -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-Enabled <$true | $false>] [-EnabledForFederation <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Type <String>] [-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. Über dieses Cmdlet wird ein vorhandenes Endpunktkontaktobjekt in Active Directory-Domänendienste (AD DS) geändert.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

UserIdParameter

Die Identität (der Distinguished Name) oder SIP-Adresse des zu ändernden Anwendungsendpunkts.

DisplayName

Optional

Zeichenfolge

Der Anzeigename des Endpunktkontaktobjekts.

DisplayNumber

Optional

Zeichenfolge

Die im Adressbuch angezeigte Telefonnummer des Kontakts.

Enabled

Optional

Boolescher Wert

Legt fest, ob der Kontakt für Lync Server 2010 aktiviert ist.

Standard: True

EnabledForFederation

Optional

Boolescher Wert

Legt fest, ob Partnerbenutzer auf diesen Kontakt zugreifen können.

Standard: False

EnterpriseVoiceEnabled

Optional

Boolescher Wert

Legt fest, ob der Kontakt für Enterprise-VoIP aktiviert ist.

Standard: True

LineURI

Optional

Zeichenfolge

Die Telefonnummer des Kontakts. Die Nummer muss mit dem Format "TEL:<Nummer>" angegeben werden. Beispiel: TEL:+14255551212.

PrimaryLanguage

Optional

Int32

Die primäre Sprache, die für die vertrauenswürdige Anwendung verwendet wird. Die Sprache muss über einen gültigen Sprachcode konfiguriert werden, z. B. "en-US" (US-Englisch), "fr-FR" (Französisch) etc.

SecondaryLanguages

Optional

MultiValuedProperty

Eine Auflistung von Sprachen, die auch für vertrauenswürdige Anwendungen verwendet werden können. Werte müssen als durch Trennzeichen getrennte Werteliste von Sprachcodes konfiguriert werden. Beispielsweise werden durch die folgende Syntax kanadisches Französisch und Französisch als sekundäre Sprachen festgelegt: -SecondaryLanguages "fr-CA","fr-FR".

SipAddress

Optional

Zeichenfolge

Die SIP-Adresse eines Kontakts kann nicht geändert werden. Die SIP-Adresse wird beim Erstellen des Anwendungsendpunkts zugewiesen.

Type

Optional

Zeichenfolge

Dieser Parameter wird mit diesem Cmdlet nicht verwendet.

PassThru

Optional

Switch-Parameter

Wenn dieser Parameter aufgenommen wird, wird das Kontaktobjekt beim Ausführen des Cmdlets nicht nur geändert, sondern als Ausgabe wird zudem das neue Objekt zurückgegeben.

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. Es ändert ein Objekt vom Typ "Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact".

Beispiel

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

Set-CsTrustedApplicationEndpoint -Identity "sip:endpoint1@litwareinc.com" -DisplayName "Endpoint 1"

In diesem Beispiel wird das Anwendungsendpunkt-Kontaktobjekt mit der SIP-Adresse "endpoint1@litwareinc.com" geändert. Beachten Sie, dass der Identitätswert mit der Zeichenfolge "sip:" beginnt, auf welche die SIP-Adresse folgt. Dem nächsten Parameter, "DisplayName", wird der Wert "Endpoint 1" zugewiesen, sodass der Anzeigename des Kontakts in diesen Wert geändert wird.

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

Get-CsTrustedApplicationEndpoint -Identity "Endpoint 1" | Set-CsTrustedApplicationEndpoint -DisplayNumber "(425)555-1212"

In diesem Beispiel wird der Anzeigename der Endpunktanwendung mit dem Anzeigenamen "Endpoint 1" geändert. Der Befehl ruft zunächst Get-CsTrustedApplicationEndpoint mit der Identität "Endpoint 1" auf, um das Endpunktkontaktobjekt mit diesem Anzeigenamen abzurufen. Dieses Objekt wird anschließend an das Cmdlet Set-CsTrustedApplicationEndpoint weitergeleitet, das den Anzeigenamen in den angegebenen Wert, "(425)555-1212", ändert.