Get-CsAdContact
Letztes Änderungsdatum des Themas: 2012-03-23
In einer Topologie mit mehreren Gesamtstrukturen werden Informationen zu Benutzerkonten aus anderen Gesamtstrukturen als Ihrer Basisgesamtstruktur zurückgegeben. Dabei handelt es sich um Benutzer, die mit Microsoft Forefront Identity Manager 2010 (oder einer früheren Version des Produkts) als Kontaktobjekte repliziert wurden. Mit Get-CsAdContact wird jeder Benutzer zurückgegeben, der für das Attribut "msRTCSIP-OriginatorSid" einen Wert konfiguriert hat.
Syntax
Get-CsAdContact [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LDAPFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
Detaillierte Beschreibung
In einer Topologie mit mehreren Gesamtstrukturen werden Benutzer aus anderen Gesamtstrukturen als Kontakte dargestellt. Diese Kontakte entsprechen nicht den Active Directory-Kontakten. Wenn Sie Active Directory-Benutzer und Computer zum Erstellen eines neuen Kontakts verwenden, wird dieser Benutzer vom Cmdlet Get-CsAdContact nicht zurückgegeben. Stattdessen werden mit Get-CsAdContact nur Informationen zu Benutzern aus anderen Gesamtstrukturen als Ihrer Basisgesamtstruktur zurückgegeben. Wenn keine Topologie mit mehreren Gesamtstrukturen vorhanden ist, muss Get-CsAdContact nicht aufgerufen werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsAdContact lokal auszufü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-CsAdContact"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
UserId-Parameter |
Gibt die Identität des zurückzugebenden Kontakts an. Kontaktidentitäten können in den folgenden drei Formaten angegeben werden: als 1) SIP-Adresse des Kontakts, 2) Active Directory Distinguished Name des Kontakts und als 3) Active Directory-Anzeigename des Kontakts (z. B. "Ken Myer"). Sie können das Sternchen (*) als Platzhalterzeichen nutzen, wenn Sie den Anzeigenamen als Kontaktidentität verwenden. Der Identitätswert "* Smith" gibt beispielsweise alle Kontakte zurück, deren Anzeigename mit der Zeichenfolge "Smith" endet. |
Credential |
Optional |
PS-Objekt mit Anmeldeinformationen |
Ermöglicht die Ausführung des Cmdlets Get-CsAdContact 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 mit dem Cmdlet Get-Credential das PS-Objekt mit Anmeldeinformationen erstellt werden. Ausführliche Informationen finden Sie im Hilfethema "Get-Credential". |
DomainController |
Optional |
Zeichenfolge |
Ermöglicht es Ihnen, zum Abrufen von Kontaktinformationen eine Verbindung mit dem angegebenen Domänencontroller herzustellen. Um eine Verbindung mit einem bestimmten Domänencontroller herzustellen, fügen Sie den Parameter "DomainController" ein, gefolgt vom vollqualifizierten Domänennamen (z. B. "atl-cs-001.litwareinc.com"). |
Filter |
Optional |
Zeichenfolge |
Ermöglicht die Einschränkung der zurückgegebenen Daten, indem diese nach Microsoft Lync Server 2010-spezifischen Attributen gefiltert werden. Der Parameter "Filter" verwendet dieselbe Windows PowerShell-Filterungssyntax wie das Cmdlet Where-Object. Ein Filter, mit dem nur Kontakte zurückgegeben werden, deren SIP-Adresse mit "fabrikam.com" endet, sieht beispielsweise folgendermaßen aus: {SipAddress -like "*@fabrikam.com"}, wobei "SipAddress" das Active Directory-Attribut, "-like" den Vergleichsoperator und "*@fabrikam.com" den Filterwert darstellt. |
LdapFilter |
Optional |
Zeichenfolge |
Ermöglicht die Einschränkung der zurückgegebenen Daten, indem diese nach allgemeinen Active Directory-Attributen gefiltert werden. Beispielsweise können die zurückgegebenen Daten auf Kontakte beschränkt werden, die in einer bestimmten Abteilung arbeiten, oder auf Kontakte mit einem bestimmten Vorgesetzten oder einer bestimmten Position. Der Parameter "LdapFilter" verwendet beim Erstellen von Filtern die LDAP-Abfragesprache. Ein Filter, mit dem der Kontakt mit der Telefonnummer 1-425-555-1298 zurückgegeben wird, sieht beispielsweise folgendermaßen aus: "telephoneNumber=1-425-555-1298", wobei "telephoneNumber" das Active Directory-Attribut, "=" den Vergleichsoperator (equal to) und "1-425-555-1298" den Filterwert darstellt. |
OU |
Optional |
Distinguished Name |
Ermöglicht es Ihnen, die zurückgegebenen Informationen aus einer bestimmten Active Directory-Organisationseinheit (Organizational Unit, OU) oder aus einem bestimmten Container einzuschränken. Mit diesem Parameter werden Daten aus der angegebenen Organisationseinheit und allen untergeordneten Organisationseinheiten zurückgegeben. Wenn die OU "Finance" z. B. über zwei untergeordnete OUs verfügt – "AccountsPayable" und "AccountsReceivable" – werden alle Kontakte aus diesen drei Organisationseinheiten zurückgegeben. Verwenden Sie beim Angeben einer Organisationseinheit den Distinguished Name des Containers. Beispiel: OU=Finance,dc=litwareinc,dc=com. |
ResultSize |
Optional |
Ganze Zahl |
Ermöglicht es Ihnen, die Anzahl der vom Cmdlet zurückgegebenen Datensätze einzuschränken. Um beispielsweise sieben Kontakte (unabhängig von der Gesamtzahl der Kontakte in der Gesamtstruktur) zurückzugeben, verwenden Sie den Parameter "ResultSize", und legen Sie den Parameterwert auf 7 fest. Beachten Sie, dass nicht garantiert werden kann, welche sieben Benutzer zurückgegeben werden. Für die Ergebnisgröße kann ein ganzzahliger Wert zwischen einschließlich 0 und 2147483647 festgelegt werden. Bei Festlegung von 0 wird der Befehl ausgeführt, es werden jedoch keine Daten zurückgegeben. 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. |
Eingabetypen
Zeichenfolge. Get-CsAdContact akzeptiert einen weitergeleiteten Zeichenfolgenwert, der den Identitätswert eines Benutzerkontos darstellt.
Rückgabetypen
Mit Get-CsAdContact werden Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.ADContact" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 ------------------------
Get-CsAdContact
Der Befehl in Beispiel 1 gibt eine Auflistung aller Kontakte in der Topologie mit mehreren Gesamtstrukturen in Active Directory-Domänendienste (AD DS) zurück. Mit dem Aufruf von Get-CsAdContact ohne zusätzliche Parameter werden alle Eigenschaftswerte für alle Active Directory-Kontakte zurückgegeben.
-------------------------- Beispiel 2 ------------------------
Get-CsAdContact | Select-Object DisplayName, SipAddress
In Beispiel 2 wird eine Auflistung aller Active Directory-Kontakte zurückgegeben. In diesem Fall wird die Auflistung jedoch an das Cmdlet Select-Object weitergeleitet, das nur die zwei Attribute festlegt, die auf dem Bildschirm angezeigt werden: "DisplayName" und "SipAddress".
-------------------------- Beispiel 3 ------------------------
Get-CsAdContact -Identity "Ken Myer"
Mit dem vorstehenden Befehl werden die Informationen für einen einzelnen Active Directory-Kontakt zurückgegeben: den Kontakt mit der Identität "Ken Myer".
-------------------------- Beispiel 4 ------------------------
Get-CsAdContact -LdapFilter "Organization=Fabrikam"
In Beispiel 4 werden mit dem Befehl alle Active Directory-Kontakte zurückgegeben, die für "Fabrikam" arbeiten. Zu diesem Zweck wird Get-CsAdContact mit dem Parameter "LdapFilter" aufgerufen. In diesem Beispiel werden damit die zurückgegebenen Daten auf die Kontakte beschränkt, deren Attribut "Organization" auf "Fabrikam" festgelegt ist.
-------------------------- Beispiel 5 ------------------------
$x = Get-Credential -Credential "litwareinc\administrator"
Get-CsAdContact -Credential $x
Die zwei Befehle in Beispiel 5 zeigen die Verwendung des Parameters "Credential", mit dem Sie Get-CsAdContact mit anderen Anmeldeinformationen ausführen können. Mit dem ersten Befehl wird das Cmdlet Get-Credential aufgerufen, um ein PS-Objekt mit Anmeldeinformationen für das Konto "litwareinc\administrator" zu erstellen. Durch diesen Befehl wird ein Dialogfeld angezeigt, in dem der Benutzer "litwareinc\administrator" zur Eingabe von Anmeldeinformationen aufgefordert wird. Nachdem Sie ein Kennwort für dieses Konto eingegeben haben, werden die Anmeldeinformationen in der Variablen "$x" gespeichert. Mit dem zweiten Befehl wird Get-CsAdContact mit dem Parameter "Credential" aufgerufen. Der Parameterwert "$x" gibt an, dass Get-CsAdContact unter dem Konto "litwareinc\administrator" ausgeführt werden soll.