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.
Siehe auch
Weitere Ressourcen
New-CsExUmContact
Remove-CsExUmContact
Set-CsExUmContact
Move-CsExUmContact