Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Get-UserPhoto

 

Gilt für:Exchange Online, Exchange Server 2016

Letztes Änderungsdatum des Themas:2018-01-16

Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im Cloud-basierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.

Verwenden Sie das Cmdlet Get-UserPhoto, um Informationen zur Benutzerfotofunktion anzuzeigen, mit der Benutzer ihrem Konto ein Foto zuordnen können. Benutzerfotos werden in lokalen und cloudbasierten Clientanwendungen wie Outlook im Web, Lync, Skype for Business und SharePoint angezeigt.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Get-UserPhoto [-Identity <MailboxIdParameter>] <COMMON PARAMETERS>

Get-UserPhoto [-Anr <String>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-GroupMailbox <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PhotoType <String>] [-Preview <SwitchParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

In diesem Beispiel werden Informationen zum Benutzerfoto angezeigt, das für Susan Burk konfiguriert wurde.

Get-UserPhoto "Susan Burk"

In diesem Beispiel werden Informationen zum Benutzerfoto angezeigt, das für das Konto von Pilar Pinilla hochgeladen, aber nicht gespeichert wurde.

Get-UserPhoto "Pilar Pinilla" -Preview

Mit der Funktion für Benutzerfotos können die Benutzer ihrem Konto ein Bild zuordnen. Benutzerfotos werden im Active Directory-Konto und im Stammverzeichnis des Exchange-Postfachs des Benutzers gespeichert. Die Benutzerfotofunktion muss für einen Benutzer festgelegt werden, bevor Sie das Cmdlet Get-UserPhoto ausführen können, um Informationen zum Foto des Benutzers anzuzeigen. Andernfalls erhalten Sie eine Fehlermeldung, die darauf hinweist, dass das Benutzerfoto für die angegebenen Benutzer nicht vorhanden ist. Administratoren verwenden das Set-UserPhoto-Cmdlet oder die Exchange-Verwaltungskonsole (EAC) zum Konfigurieren von Benutzerfotos. Benutzer können über die Seite "Outlook im Web-Optionen" ein Benutzerfoto hochladen, eine Vorschau darauf anzeigen und es für ihr Konto speichern.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. In diesem Thema sind zwar alle Parameter für das Cmdlet aufgeführt, aber Sie verfügen möglicherweise nicht über Zugriff auf einige Parameter, falls diese nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Informationen zu den von Ihnen benötigten Berechtigungen finden Sie unter "Berechtigungen für die Empfängerbereitstellung" im Thema Empfängerberechtigungen.

 

Parameter Erforderlich Typ Beschreibung

Anr

Optional

System.String

Der Parameter Anr gibt eine Zeichenfolge an, für die eine Suche zur Auflösung eines nicht eindeutigen Namens (Ambiguous Name Resolution, ANR) durchgeführt wird. Sie können eine Teilzeichenfolge angeben und nach Objekten mit einem Attribut suchen, das der Zeichenfolge entspricht. Die gesuchten Standardattribute umfassen:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

Optional

System.Management.Automation.PSCredential

Der Parameter Credential gibt den Benutzernamen und das Kennwort an, die zum Ausführen dieses Befehls verwendet werden. Normalerweise verwenden Sie diesen Parameter in Skripts oder wenn Sie unterschiedliche Anmeldeinformationen bereitstellen müssen, die über die erforderlichen Berechtigungen verfügen.

Dieser Parameter erfordert die Erstellung und Übergabe eines Anmeldeinformationsobjekts. Dieses Anmeldeinformationsobjekt wird mithilfe des Cmdlets Get-Credential erstellt. Weitere Informationen finden Sie unter Get-Credential.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Dieser Parameter ist nur in der lokalen Exchange-Bereitstellung verfügbar.

Der Parameter DomainController gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Zum Beispiel dc01.contoso.com.

Filter

Optional

System.String

Der Parameter Filter verwendet die OPATH-Filtersyntax, um die Ergebnisse nach den angegebenen Eigenschaften und Werten zu filtern. Die Suchkriterien verwenden die Syntax {<Property> -<Comparison operator> '<Value>'}.

  • <Property> ist eine filterbare Eigenschaft.

  • Bei -<Comparison Operator> handelt es sich um einen OPATH-Vergleichsoperator. Zum Beispiel -eq für Übereinstimmungen und -like für den Zeichenfolgenvergleich. Weitere Informationen über Vergleichsoperatoren finden Sie unter about_Comparison_Operators.

  • <Value> ist der Eigenschaftswert. Textwerte mit oder ohne Leerzeichen müssen in Anführungszeichen gesetzt werden ('<Value>'). Verwenden Sie Anführungszeichen nicht mit ganzen Zahlen oder den Systemwerten $true, $false oder $null.

Sie können mehrere Suchkriterien mithilfe der logischen Operatoren -and und -or miteinander verketten. Zum Beispiel {<Criteria1>) -and <Criteria2>} oder {(<Criteria1> -and <Criteria2>) -or <Criteria3>}.

GroupMailbox

Optional

System.Management.Automation.SwitchParameter

Der GroupMailbox-Schalter, der den angegebenen Benutzer angibt, ist eine Office 365-Gruppe. Sie müssen keinen Wert für diese Option angeben.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Der Parameter Identity gibt das Benutzerkonto an. Sie können einen beliebigen Wert verwenden, der das Benutzerkonto eindeutig identifiziert.

Beispiel:

  • Name

  • Anzeigename

  • Alias

  • Distinguished Name (DN)

  • Kanonischer DN

  • <domain name>\<account name>

  • E-Mail-Adresse

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • Benutzer-ID oder User Principal Name (UPN)

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

Die Option IgnoreDefaultScope weist den Befehl an, die Standardeinstellung für den Empfängerbereich für die Exchange-Verwaltungsshell-Sitzung zu ignorieren und die vollständige Gesamtstruktur als Bereich zu verwenden. Dadurch kann der Befehl auf Active Directory-Objekte zugreifen, die aktuell nicht im Standardbereich verfügbar sind.

Die Verwendung des Switchs IgnoreDefaultScope bringt die folgenden Einschränkungen mit sich:

  • Sie können den Parameter DomainController nicht verwenden. Der Befehl verwendet automatisch einen geeigneten globalen Katalogserver.

  • Für den Identity-Parameter kann nur der DN verwendet werden. Andere Formen der Identifikation wie Aliasnamen oder GUIDs werden nicht akzeptiert.

OrganizationalUnit

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Der Parameter OrganizationalUnit filtert die Ergebnisse anhand der Position des Objekts in Active Directory. Es werden nur Objekte zurückgegeben, die am angegebenen Speicherort vorhanden sind. Eine gültige Eingabe für diesen Parameter ist eine Organisationseinheit oder Domäne, die mithilfe des Cmdlets Get-OrganizationalUnit sichtbar ist. Sie können jeden beliebigen Wert verwenden, sofern er die Organisationseinheit oder Domäne eindeutig kennzeichnet. Beispiel:

  • Name

  • Kanonischer Name

  • Distinguished Name (DN)

  • GUID

PhotoType

Optional

System.String

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Preview

Optional

System.Management.Automation.SwitchParameter

Der Preview-Schalter filtert die Ergebnisse nach Vorschaufotos. Sie müssen keinen Wert für diese Option angeben.

Ein Vorschaufoto ist ein Foto, das auf das Benutzerkonto hochgeladen, jedoch nicht gespeichert wurde, z. B. wenn ein Benutzer ein Foto in die Outlook im Web-Optionen hochlädt, sie jedoch nicht speichert. Wenn Sie den Preview-Schalter verwenden, nachdem ein Benutzerfoto gespeichert wurde, gibt dieses Cmdlet einen Fehler zurück, in dem angegeben wird, dass das Vorschaufoto nicht vorhanden ist.

ReadFromDomainController

Optional

System.Management.Automation.SwitchParameter

Die Option ReadFromDomainController gibt an, dass Informationen von einem Domänencontroller in der Domäne des Benutzers abgerufen werden sollen. Wenn Sie den Befehl Set-AdServerSettings -ViewEntireForest $true ausführen, um alle Objekte in der Gesamtstruktur einzubeziehen, und nicht die Option ReadFromDomainController verwenden, werden die Informationen möglicherweise aus einem globalen Katalog mit veralteten Informationen entnommen. Wenn Sie die Option ReadFromDomainController verwenden, sind zum Abrufen der Informationen möglicherweise mehrere Lesevorgänge erforderlich. Sie müssen mit dieser Option keinen Wert angeben.

noteHinweis:
Standardmäßig ist der Empfängerbereich auf die Domäne festgelegt, in der sich Ihre Server mit Exchange befinden.

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Der ResultSize-Parameter gibt die maximale Anzahl von zurückzugebenden Ergebnissen an. Wenn Sie alle Anforderungen zurückgeben möchten, die der Abfrage entsprechen, verwenden Sie unlimited als Wert für diesen Parameter. Der Standardwert lautet 1000.

SortBy

Optional

System.String

Der Parameter SortBy gibt die Eigenschaft an, nach der die Ergebnisse sortiert werden sollen. Sie können die Sortierung nur jeweils nach einer Eigenschaft vornehmen. Die Ergebnisse werden in absteigender Reihenfolge sortiert.

Wenn die Standardansicht nicht die Eigenschaft umfasst, nach der Sie sortieren, können Sie den Befehl mit | Format-Table -Auto <Property1>,<Property2>... anfügen, um eine neue Ansicht zu erstellen, die alle Eigenschaften aufweist, die angezeigt werden sollen. Platzhalter (*) in den Eigenschaftsnamen werden unterstützt.

Sie können nach der Id-Eigenschaft sortieren.

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Rückgabetypen bzw. Ausgabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

 
Anzeigen: