Import-RecipientDataProperty

 

Gilt für:Exchange Server 2016

Letztes Änderungsdatum des Themas:2018-01-16

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet Import-RecipientDataProperty, um einem Postfach oder Kontakt ein Bild oder eine Audiodatei eines gesprochenen Namens hinzuzufügen. Das Bild und die Audiodateien werden im Dialogfeld Globale Adressliste, auf der Kontaktkarte, im Lesebereich und in Besprechungsanfragen in Microsoft Microsoft und Microsoft OutlookOutlook im Web angezeigt.

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

Import-RecipientDataProperty [-Picture <SwitchParameter>] <COMMON PARAMETERS>
Import-RecipientDataProperty [-SpokenName <SwitchParameter>] <COMMON PARAMETERS>
COMMON PARAMETERS: -FileData <Byte[]> -Identity <MailboxUserContactIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

In diesem Beispiel wird die Audiodatei für den gesprochenen Namen "Thorsten Scholl" importiert.

Import-RecipientDataProperty -Identity "Tony Smith" -SpokenName -FileData ([Byte[]]$(Get-Content -Path "M:\AudioFiles\TonySmith.wma" -Encoding Byte -ReadCount 0))

In diesem Beispiel wird die Bilddatei für "Ayla Kol" importiert.

Import-RecipientDataProperty -Identity Ayla -Picture -FileData ([Byte[]]$(Get-Content -Path "M:\Employee Photos\AylaKol.jpg" -Encoding Byte -ReadCount 0))

Für das Importieren und Exportieren von Dateien ist eine bestimmte Syntax erforderlich, da das Importieren und Exportieren Remote-PowerShell verwendet.

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 "Eigenschaften von Empfängerdaten" im Thema Empfängerberechtigungen.

 

Parameter Erforderlich Typ Beschreibung

FileData

Erforderlich

System.Byte[]

Der Parameter FileData gibt den Speicherort und den Dateinamen des Bilds oder der Audiodatei an.

Für einen gültigen Wert für diesen Parameter, ist es erforderlich, die Datei unter Verwendung des Cmdlets Get-Content in ein bytecodiertes Objekt zu lesen. Zum Beispiel ([Byte[]](Get-Content -Encoding Byte -Path "C:\My Documents\<filename>" -ReadCount 0)).

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.MailboxUserContactIdParameter

Der Parameter Identity gibt das Postfach oder den Kontakt an, dem Sie das Bild oder die Datei mit dem gesprochenen Namen hinzufügen. Sie können einen beliebigen Wert angeben, mit dem der Benutzer eindeutig identifiziert werden kann.

Beispiel:

  • Name

  • Anzeigename

  • Distinguished Name (DN)

  • Kanonischer DN

  • GUID

Confirm

Optional

System.Management.Automation.SwitchParameter

Der Switch Confirm gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie dieser Switch sich auf das Cmdlet auswirkt, hängt davon ab, ob für den Switch vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pausefunktion, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie mithilfe der exakt folgenden Syntax die Bestätigungsaufforderung überspringen: -Confirm:$false.

  • Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pausefunktion. Bei diesen Cmdlets führt das Angeben des Confirm-Switches ohne einen Wert eine Pausefunktion ein, wodurch Sie gezwungen werden, den Befehl zu bestätigen, bevor Sie fortfahren.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

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.

Picture

Optional

System.Management.Automation.SwitchParameter

Die Option Picture gibt an, dass die zu importierende Datei eine Bilddatei ist. Sie müssen keinen Wert für diese Option angeben.

Bei dem Bild muss es sich um eine JPEG-Datei mit einer maximalen Größe von 10 Kilobytes (KB) handeln. Sie können diese Option nicht mit der Option SpokenName verwenden. Sie können jeweils nur einen Dateityp importieren.

SpokenName

Optional

System.Management.Automation.SwitchParameter

Die Option SpokenName gibt an, dass die zu importierende Datei eine Audiodatei ist. Sie müssen keinen Wert für diese Option angeben.

Die maximale Dateigröße sollte weniger als 32 KB betragen. Eines der folgenden Formate kann verwendet werden:

  • WMA 9-voice

  • PCM 8 kHz, 16 Bit, Monoformat

Sie können diese Option nicht mit der Option Picture verwenden. Sie können jeweils nur einen Dateityp importieren.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Der Switch WhatIf simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

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: