Freigeben über

  • Artikel

Get-CsExUmContact

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ruft ein oder mehrere gehostete Exchange Unified Messaging (UM)-Kontaktobjekte ab.

Syntax

Get-CsExUmContact [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

Detaillierte Beschreibung

Microsoft Lync Server 2010 wird mit Exchange UM eingesetzt, um verschiedene VoIP-bezogene Funktionen wie automatische Telefonzentralen oder den Teilnehmerzugriff bereitzustellen. Wenn Exchange UM nicht als lokaler, sondern als gehosteter Dienst bereitgestellt wird, müssen zum Verwenden einer automatischen Telefonzentrale und des Teilnehmerzugriffs Kontaktobjekte mit Windows PowerShell erstellt werden. Mit diesem Cmdlet wird mindestens einer dieser Kontakte abgerufen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsExUmContact lokal ausführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsExUmContact"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

UserIdParameter

Die eindeutige ID des Kontaktobjekts, das abgerufen werden soll. Kontaktidentitäten können in den folgenden vier Formaten angegeben werden: als 1) SIP-Adresse des Kontakts, 2) UPN (User Principal Name) des Kontakts, 3) Domänen- und Anmeldename des Kontakts (mit dem Format "Domäne\Anmeldename", z. B. "litwareinc\exum1") und 4) Anzeigename des Kontakts in Active Directory (z. B. "Team Auto Attendant").

Vollständiger Datentyp: Microsoft.Rtc.Management.AD.UserIdParameter

Filter

Optional

Zeichenfolge

Ermöglicht die Einschränkung der zurückgegebenen Daten, indem diese nach Lync Server 2010-spezifischen Attributen gefiltert werden. Sie können beispielsweise die zurückgegebenen Daten auf Kontakte beschränken, deren Anschluss-URI mit "tel:555" beginnt.

Der Parameter "Filter" verwendet dieselbe Teilmenge der Windows PowerShell-Filterungssyntax wie das Cmdlet Where-Object. Mit folgendem Filter werden beispielsweise nur Kontakte zurückgegeben, die für Enterprise-VoIP aktiviert wurden: {EnterpriseVoiceEnabled -eq $True}. Dabei ist "EnterpriseVoiceEnabled" das Active Directory-Attribut, "-eq" der Vergleichsoperator ("equal to") und "$True" (eine integrierte Windows PowerShell-Variable) der Filterwert.

LdapFilter

Optional

Zeichenfolge

Ermöglicht es Ihnen, die zurückgegebenen Daten durch das Filtern allgemeiner Active Directory-Attribute (d. h. Attribute, die nicht Lync Server-spezifisch sind) einzuschränken.

Der Parameter "LdapFilter" verwendet beim Erstellen von Filtern die LDAP-Abfragesprache.

Credential

Optional

PSCredential

Ermöglicht die Ausführung des Cmdlets mit anderen Anmeldeinformationen. Dies kann notwendig sein, wenn das für die Anmeldung bei Windows verwendete Konto nicht über die erforderlichen Berechtigungen verfügt, um mit Kontaktobjekten zu arbeiten.

Zur Verwendung des Parameters "Credential" muss zunächst über das Cmdlet Get-Credential das PS-Objekt mit Anmeldeinformationen erstellt werden.

DomainController

Optional

FQDN

Ermöglicht es Ihnen, zum Abrufen von Kontaktinformationen eine Verbindung mit dem angegebenen Domänencontroller herzustellen. Zum Herstellen einer Verbindung mit einem bestimmten Domänencontroller nehmen Sie den Parameter "DomainController" auf und geben anschließend den Computernamen (z. B. "atl-mcs-001") oder den vollqualifizierten Domänennamen (z. B. "atl-mcs-001.litwareinc.com") an.

Vollständiger Datentyp: Microsoft.Rtc.Management.Deploy.Fqdn

OU

Optional

OUIdParameter

Ermöglicht es Ihnen, die zurückgegebenen Informationen auf eine bestimmte Active Directory-Organisationseinheit (Organizational Unit, OU) einzuschränken. Beachten Sie, dass Daten von der angegebenen OU und untergeordneten OUs zurückgegeben werden.

Verwenden Sie beim Angeben einer OU den Distinguished Name (DN) des Containers. Beispiel: OU=ExUmContacts,dc=litwareinc,dc=com.

ResultSize

Optional

Ganze Zahl

Ermöglicht es Ihnen, die Anzahl von zurückgegebenen Datensätzen einzuschränken. Um beispielsweise nur sieben Kontakte (unabhängig von der Gesamtzahl der Benutzer in der Gesamtstruktur) zurückzugeben, verwenden Sie den Parameter "ResultSize", und legen Sie seinen Wert auf 7 fest. Beachten Sie, dass nicht garantiert werden kann, welche sieben Kontakte zurückgegeben werden. Wenn Sie "ResultSize" auf 7 festlegen, jedoch lediglich über drei Kontakte in Ihrer Gesamtstruktur verfügen, werden diese drei Kontakte zurückgegeben, und der Befehl wird anschließend ohne Ausgabe eines Fehlers abgeschlossen.

Für die Ergebnisgröße kann ein ganzzahliger Wert von 0 bis einschließlich 2147483647 festgelegt werden. Bei Festlegung von 0 wird der Befehl ausgeführt, es werden jedoch keine Daten zurückgegeben.

Vollständiger Datentyp: Microsoft.Rtc.Management.ADConnect.Core.Unlimited

Eingabetypen

Zeichenfolge. Akzeptiert einen weitergeleiteten Zeichenfolgenwert, der die Identität eines Exchange UM-Kontakts darstellt.

Rückgabetypen

Gibt ein Objekt vom Typ "Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact" zurück.

Beispiel

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

Get-CsExUmContact

In diesem Beispiel werden alle Exchange UM-Kontakte abgerufen, die in einer Lync Server 2010-Bereitstellung definiert sind.

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

Get-CsExUmContact -Identity sip:exum1@fabrikam.com

In diesem Beispiel wird der Exchange UM-Kontakt mit der SIP-Adresse "sip:exum1@fabrikam.com" abgerufen.

-------------------------- Beispiel 3 --------------------------

Get-CsExUmContact -Filter {Enabled -eq $False}

In diesem Beispiel wird der Parameter "Filter" zum Abrufen aller Exchange UM-Kontakte verwendet, die nicht für Lync Server 2010 aktiviert sind. Hierzu wird nach der Eigenschaft "Enabled" gefiltert, um zu überprüfen, ob diese Eigenschaft auf "$False" festgelegt ist (der Vergleichsoperator "-eq" steht für "equal to"). Über diesen Befehl zurückgegebene Kontakte funktionieren nicht.

-------------------------- Beispiel 4 --------------------------

Get-CsExUmContact -Filter {LineURI -like "tel:555*"}

Dieser Befehl filtert nach der Eigenschaft "LineURI", um alle Exchange UM-Kontakte abzurufen, deren Anschluss-URI mit "tel:555" beginnt. Anders ausgedrückt: Es werden alle Kontakte abgerufen, deren Telefonnummer mit 555 beginnt.

-------------------------- Beispiel 5 --------------------------

Get-CsExUmContact -OU "OU=ExUmContacts,DC=Vdomain,DC=com"

In diesem Beispiel wird der OU-Parameter zum Abrufen aller Exchange UM-Kontakte verwendet, die sich in der Active Directory-OU "OU=ExUmContacts,DC=Vdomain,DC=com" befinden.