Freigeben über


Set-User

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

Verwenden Sie das Cmdlet Set-User, um Benutzerattribute zu ändern. Sie können dieses Cmdlet verwenden, um alle Objekte zu ändern, die über Benutzerkonten verfügen (z. B. Benutzerpostfächer, E-Mail-Benutzer und Benutzerkonten).

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

Syntax

Set-User
   [-Identity] <UserIdParameter>
   [-AllowUMCallsFromNonUsers <AllowUMCallsFromNonUsersFlags>]
   [-Arbitration]
   [-AssistantName <String>]
   [-AuthenticationPolicy <String>]
   [-BlockCloudCache <Boolean>]
   [-CanHaveCloudCache <Boolean>]
   [-CertificateSubject <MultiValuedProperty>]
   [-City <String>]
   [-ClearDataEncryptionPolicy]
   [-Company <String>]
   [-Confirm]
   [-CountryOrRegion <CountryInfo>]
   [-CreateDTMFMap <Boolean>]
   [-Department <String>]
   [-DesiredWorkloads <MailboxWorkloadFlags>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-Fax <String>]
   [-FirstName <String>]
   [-Force]
   [-GeoCoordinates <GeoCoordinates>]
   [-HomePhone <String>]
   [-IgnoreDefaultScope]
   [-Initials <String>]
   [-LastName <String>]
   [-LinkedCredential <PSCredential>]
   [-LinkedDomainController <String>]
   [-LinkedMasterAccount <UserIdParameter>]
   [-MailboxRegion <String>]
   [-MailboxRegionSuffix <MailboxRegionSuffixValue>]
   [-Manager <UserContactIdParameter>]
   [-MobilePhone <String>]
   [-Name <String>]
   [-Notes <String>]
   [-Office <String>]
   [-OtherFax <MultiValuedProperty>]
   [-OtherHomePhone <MultiValuedProperty>]
   [-OtherTelephone <MultiValuedProperty>]
   [-Pager <String>]
   [-PermanentlyClearPreviousMailboxInfo]
   [-Phone <String>]
   [-PhoneticDisplayName <String>]
   [-PostalCode <String>]
   [-PostOfficeBox <MultiValuedProperty>]
   [-PublicFolder]
   [-RemotePowerShellEnabled <Boolean>]
   [-RemoveMailboxProvisioningConstraint]
   [-ResetPasswordOnNextLogon <Boolean>]
   [-SamAccountName <String>]
   [-SeniorityIndex <Int32>]
   [-SimpleDisplayName <String>]
   [-SkipDualWrite]
   [-StateOrProvince <String>]
   [-StreetAddress <String>]
   [-StsRefreshTokensValidFrom <DateTime>]
   [-TelephoneAssistant <String>]
   [-Title <String>]
   [-UMCallingLineIds <MultiValuedProperty>]
   [-UMDtmfMap <MultiValuedProperty>]
   [-UserPrincipalName <String>]
   [-VIP <Boolean>]
   [-WebPage <String>]
   [-WhatIf]
   [-WindowsEmailAddress <SmtpAddress>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-User enthält keine E-Mail-bezogenen Eigenschaften für Postfächer oder E-Mail-Benutzer. Um die E-Mail-bezogenen Eigenschaften für einen Benutzer zu ändern, müssen Sie das entsprechende Cmdlet basierend auf dem Objekttyp verwenden (z. B. Set-Mailbox oder Set-MailUser).

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Set-User -Identity Contoso\Jill -DisplayName "Jill Frank"

In diesem Beispiel wird der Anzeigename für "Jill Frank" festgelegt.

Beispiel 2

Set-User -Identity Kweku@fabrikam.com -LinkedMasterAccount $null

In diesem Beispiel wird die Verknüpfung des verknüpften Postfachs Kweku@fabrikam.com aufheben und in ein Benutzerpostfach konvertiert, indem der LinkedMasterAccount-Parameter auf $null festgelegt wird.

Wenn Sie dieses Verfahren für ein verknüpftes Postfach ausführen, werden alle Berechtigungen für das Postfach entfernt, z. B. Senden als, Vollzugriff, Ordner- und Kalenderdelegierung.

Parameter

-AllowUMCallsFromNonUsers

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der AllowUMCallsFromNonUsers-Parameter gibt an, ob der Benutzer von Unified Messaging-Verzeichnissuchen ausgeschlossen werden soll.

Type:AllowUMCallsFromNonUsersFlags
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Arbitration

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Schalter "Schiedsverfahren" ist erforderlich, um Vermittlungspostfächer zu ändern. Sie müssen keinen Wert für diese Option angeben.

Vermittlungspostfächer sind Systempostfächer, die zum Speichern verschiedener Arten von Systemdaten und zum Verwalten des Nachrichtengenehmigungsworkflows verwendet werden.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-AssistantName

Der Parameter AssistantName gibt den Namen des Assistenten des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-AuthenticationPolicy

Der Parameter AuthenticationPolicy gibt die Authentifizierungsrichtlinie an, die auf den Benutzer angewendet werden soll. Sie können einen beliebigen Wert verwenden, der die Richtlinie eindeutig identifiziert. Beispiel:

  • Name
  • Distinguished Name (DN)
  • GUID

Um die Richtlinienzuweisung für den Benutzer zu entfernen, verwenden Sie den Wert $null.

Sie erstellen Authentifizierungsrichtlinien mit dem Cmdlet New-AuthenticationPolicy, um die Standardauthentifizierung oder (in Exchange 2019 CU2 oder höher) andere Legacyauthentifizierungsmethoden zu blockieren oder selektiv zuzulassen.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2019, Exchange Online, Exchange Online Protection

-BlockCloudCache

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill BlockCloudCache Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-CanHaveCloudCache

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill CanHaveCloudCache Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-CertificateSubject

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der Parameter CertificateSubject gibt den Wert des Felds "Betreff" des digitalen Zertifikats des Benutzers an.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-City

Der Parameter City gibt den Ort des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ClearDataEncryptionPolicy

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill ClearDataEncryptionPolicy Description }}

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Company

Der Parameter Company gibt die Firma des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Confirm

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

  • Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CountryOrRegion

Der Parameter CountryOrRegion gibt das Land oder die Region des Benutzers an. Ein gültiger Wert ist ein gültiger aus zwei Buchstaben bestehender ISO 3166-1-Ländercode (z. B. AU für Australien) oder der entsprechende Anzeigename für das Land (der sich vom offiziellen Kurznamen der ISO 3166 Maintenance Agency unterscheiden kann).

Eine Referenz für zweistellige Ländercodes finden Sie unter Ländercodeliste.

Der Anzeigename wird im Wert der CountryOrRegion-Eigenschaft vom Cmdlet Get-User zurückgegeben. Sie können jedoch entweder den Anzeigenamen oder den zweistelligen Ländercode in Filtervorgängen verwenden.

Type:CountryInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CreateDTMFMap

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter CreateDTMFMap gibt an, ob eine DTMF-Karte (Dual-Tone Multiple-Frequency) für den Empfänger erstellt werden soll. Dadurch kann der Empfänger mithilfe einer Telefontataatur in Unified Messaging-Umgebungen (UM) identifiziert werden. Gültige Werte sind:

  • $true: Für den Empfänger wird eine DTMF-Karte erstellt. Dies ist der Standardwert.
  • $true: Für den Empfänger wird eine DTMF-Zuordnung erstellt. Dies ist der Standardwert.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Department

Der Parameter Department gibt die Abteilung des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DesiredWorkloads

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill DesiredWorkloads Description }}

Type:Microsoft.Exchange.Data.MailboxWorkloadFlags
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-DisplayName

Der Parameter DisplayName gibt den Anzeigenamen des Benutzers an. Der Anzeigename wird im Exchange Admin Center und in Active Directory angezeigt. Die Höchstlänge beträgt 256 Zeichen. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

Dieser Parameter ist im lokalen Exchange 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. Beispiel: dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Fax

Der Parameter Fax gibt die Faxnummer des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-FirstName

Der Parameter FirstName gibt den Vornamen des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Force

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.

Sie können diesen Switch verwenden, um Aufgaben in Fällen programmgesteuert auszuführen, in denen die administrative Eingabe unangemessen ist.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-GeoCoordinates

Der GeoCoordinates-Parameter gibt die Position des Benutzers in Breiten-, Längen- und (optional) Höhenkoordinaten an. Ein gültiger Wert für diesen Parameter verwendet eines der folgenden Formate:

  • Breiten- und Längengrad: Beispiel: "47,644125;-122.122411"
  • Breitengrad, Längengrad und Höhe: Beispiel: "47.644125;-122.122411;161.432"

Hinweis: Wenn Punkttrennzeichen für Sie nicht funktionieren, verwenden Sie stattdessen Kommas.

Type:GeoCoordinates
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-HomePhone

Der Parameter HomePhone gibt die private Telefonnummer des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Identity

Der Parameter Identity gibt den Benutzer an, den Sie ändern möchten. Sie können einen beliebigen Wert angeben, mit dem der Benutzer eindeutig identifiziert werden kann. Beispiel:

  • Name
  • Benutzerprinzipalname (User Principal Name, UPN)
  • Distinguished Name (DN)
  • Distinguished Name (DN)
  • GUID
  • UserPrincipalName
Type:UserIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IgnoreDefaultScope

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Die Option IgnoreDefaultScope weist den Befehl an, die Standardeinstellung für den Empfängerbereich für die Exchange PowerShell-Sitzung zu ignorieren und die komplette Gesamtstruktur als Bereich zu verwenden. Sie müssen keinen Wert für diese Option angeben.

Dieser Switch ermöglicht dem Befehl den Zugriff auf Active Directory-Objekte, die derzeit nicht im Standardbereich verfügbar sind, führt aber auch die folgenden Einschränkungen ein:

  • Sie können den Parameter DomainController nicht verwenden. Der Befehl verwendet automatisch einen geeigneten globalen Katalogserver.
  • Sie können nur den DN für den Identitätsparameter verwenden. Andere Formen der Identifikation wie Aliasnamen oder GUIDs werden nicht akzeptiert.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Initials

Der Parameter Initials gibt die Initialen des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-LastName

Der Parameter LastName gibt den Nachnamen des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-LinkedCredential

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der LinkedCredential-Parameter gibt den Benutzernamen und das Kennwort an, die für den Zugriff auf den durch den LinkedDomainController-Parameter angegebenen Domänencontroller verwendet werden.

Ein Wert für diesen Parameter setzt das Cmdlet "Get-Credential" voraus. Verwenden Sie den Wert (Get-Credential), um diesen Befehl anzuhalten und eine Aufforderung zur Eingabe von Anmeldeinformationen zu erhalten. Oder speichern Sie die Anmeldeinformationen in einer Variablen (beispielsweise $cred = Get-Credential), bevor Sie diesen Befehl ausführen, und verwenden Sie dann den Variablennamen ($cred) für diesen Parameter. Weitere Informationen finden Sie unter Get-Credential.

Sie können den Parameter LinkedCredential nur mit einem verknüpften Benutzer verwenden.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LinkedDomainController

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der Parameter LinkedDomainController gibt den Domänencontroller in der Gesamtstruktur an, in der sich das Benutzerkonto befindet, wenn es sich bei diesem Benutzer um einen verknüpften Benutzer handelt. Der Domänencontroller in der Gesamtstruktur, in der sich das Benutzerkonto befindet, wird zum Abrufen von Sicherheitsinformationen für das durch den Parameter LinkedMasterAccount angegebene Konto verwendet.

Dieser Parameter ist nur erforderlich, wenn Sie einen verknüpften Benutzer verbinden.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LinkedMasterAccount

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter LinkedMasterAccount gibt das Hauptkonto in der Gesamtstruktur an, in der sich das Benutzerkonto befindet, wenn es sich bei diesem Benutzer um einen verknüpften Benutzer handelt. Das Hauptkonto ist das Konto, mit dem der Benutzer verknüpft ist. Das Hauptkonto gewährt den Zugriff auf den Benutzer. Sie können einen der folgenden Werte verwenden:

  • GUID
  • DN
  • Domäne\Konto
  • UPN
  • LegacyExchangeDN
  • SmtpAddress
  • Alias
  • $null

Wenn Sie den Wert dieses Parameters auf $null festlegen, heben Sie die Verknüpfung des Kontos auf und konvertieren das verknüpfte Postfach in ein nicht verknüpftes Benutzerpostfach. Das Postfach behält die zuvor dafür festgelegten Berechtigungen wie "Senden als", Vollzugriff, Ordner- und Kalenderdelegierung nicht bei.

Dieser Parameter ist nur erforderlich, wenn Sie einen verknüpften Benutzer verbinden.

Type:UserIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MailboxRegion

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill MailboxRegion Description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-MailboxRegionSuffix

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill MailboxRegionSuffix Description }}

Type:MailboxRegionSuffixValue
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Manager

Der Parameter Manager gibt den Manager des Benutzers an.

Type:UserContactIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MobilePhone

Der Parameter MobilePhone gibt die primäre Mobiltelefonnummer des Benutzers an.

Hinweis: In Exchange Online können Sie diesen Parameter nicht verwenden. Verwenden Sie stattdessen den Parameter MobilePhone im Cmdlet Update-MgUser in Microsoft Graph PowerShell.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Name

Der Parameter Name gibt den eindeutigen Namen des Benutzers an. Die Höchstlänge beträgt 64 Zeichen. Wenn der Wert Leerzeichen enthält, müssen Sie ihn in Anführungszeichen (") setzen.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Notes

Der Parameter Notes gibt zusätzliche Informationen zum Objekt an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Office

Der Parameter Office gibt den Namen oder die Nummer des physischen Büroraums des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OtherFax

Der Parameter OtherFax gibt die alternative Faxnummer des Benutzers an.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OtherHomePhone

Der Parameter OtherHomePhone gibt die alternative private Telefonnummer des Benutzers an.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OtherTelephone

Der Parameter OtherTelephone gibt die alternative Telefonnummer des Benutzers an.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Pager

Der Parameter Pager gibt die Pagernummer des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PermanentlyClearPreviousMailboxInfo

Dieser Parameter ist in lokalem Exchange nicht verfügbar oder funktioniert nicht. Sie ist nur in Exchange Online verfügbar.

Der Schalter PermanentClearPreviousMailboxInfo gibt an, ob die Exchange Online Postfachattribute für einen Benutzer gelöscht werden sollen. Sie müssen bei dieser Option keinen Wert angeben.

Das Löschen dieser Attribute kann in Szenarien zum Verschieben und Erneuten Lizenzierung von Postfächern zwischen dem lokalen Exchange und Microsoft 365 erforderlich sein. Weitere Informationen finden Sie unter Dauerhaftes Löschen vorheriger Postfachinformationen.

Achtung: Dieser Schalter löscht das vorhandene Cloudpostfach und das zugehörige Archiv dauerhaft, verhindert, dass Sie erneut eine Verbindung mit dem Postfach herstellen und verhindern, dass Sie Inhalte aus dem Postfach wiederherstellen.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Phone

Der Parameter Phone gibt die geschäftliche Telefonnummer des Benutzers an.

Hinweis: In Exchange Online können Sie diesen Parameter nicht verwenden. Verwenden Sie stattdessen den Parameter BusinessPhones im Cmdlet Update-MgUser in Microsoft Graph PowerShell.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PhoneticDisplayName

Der Parameter PhoneticDisplayName gibt eine alternative Schreibweise des Benutzernamens an, der für Text-zu-Sprache-Elemente in UM-Umgebungen (Unified Messaging) verwendet wird. Dieser Parameter wird für gewöhnlich verwendet, wenn die Aussprache und Schreibweise des Benutzernamens nicht übereinstimmen. Die Höchstlänge beträgt 256 Zeichen. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PostalCode

Der Parameter PostalCode gibt die Postleitzahl des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PostOfficeBox

Der Parameter PostOfficeBox gibt die Postfachnummer des Benutzers an.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PublicFolder

Der Schalter PublicFolder ist erforderlich, um Postfächer für öffentliche Ordner zu ändern. Sie müssen keinen Wert für diese Option angeben.

Postfächer für öffentliche Ordner wurden eigens entworfen, um die Hierarchie und Inhalte von öffentlichen Ordnern zu speichern.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-RemotePowerShellEnabled

Der Parameter RemotePowerShellEnabled gibt an, ob der Benutzer Zugriff auf Remote-PowerShell hat. Remote-PowerShell-Zugriff ist erforderlich, um die Exchange-Verwaltungsshell oder das Exchange Admin Center (EAC) zu öffnen, auch wenn Sie versuchen, die Exchange-Verwaltungsshell oder das EAC auf dem lokalen Postfachserver zu öffnen. Gültige Werte sind:

  • $true: Der Benutzer hat Zugriff auf Remote-PowerShell.
  • $false: Der Benutzer hat keinen Zugriff auf Remote-PowerShell.

Der Standardwert hängt von den Verwaltungsrollen ab, die dem Benutzer zugewiesen sind.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-RemoveMailboxProvisioningConstraint

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ResetPasswordOnNextLogon

Der Parameter ResetPasswordOnNextLogon gibt an, ob der Benutzer sein Kennwort bei der nächsten Anmeldung ändern muss. Gültige Werte sind:

  • $true: Der Benutzer muss sein Kennwort bei der nächsten Anmeldung ändern.
  • $false: Der Benutzer muss sein Kennwort bei der nächsten Anmeldung nicht ändern. Dies ist der Standardwert.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SamAccountName

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der Parameter SamAccountName (auch als Benutzerkonto oder Gruppenname vor Windows 2000 bezeichnet) gibt einen Objektbezeichner an, der mit älteren Versionen von Microsoft Windows-Client- und Serverbetriebssystemen kompatibel ist. Der Wert kann Buchstaben, Zahlen, Leerzeichen, Punkte (.) und die folgenden Zeichen enthalten: !, #, $, %, ^, &-, _, {, }und ~. Das letzte Zeichen darf kein Punkt sein. Unicode-Zeichen sind zulässig, aber akzentierte Zeichen können Konflikte verursachen (z. B. o und ö übereinstimmen). Die maximale Länge beträgt 20 Zeichen.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SeniorityIndex

Der Parameter SeniorityIndex gibt die Reihenfolge für die Anzeige dieses Benutzers in einem hierarchischen Adressbuch an. Ein Benutzer mit dem Wert 2 wird in einem Adressbuch vor einem Benutzer mit dem Wert 1 angezeigt.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SimpleDisplayName

Der SimpleDisplayName-Parameter wird verwendet, um eine alternative Beschreibung des Objekts anzuzeigen, wenn nur eine begrenzte Anzahl von Zeichen zulässig ist. Gültige Zeichen sind:

  • Der SimpleDisplayName-Parameter dient zum Anzeigen einer alternativen Beschreibung des Objekts, wenn nur eine begrenzte Menge von Zeichen zulässig ist. Zulässige Zeichen sind:
  • a-z
  • A-Z
  • Leerzeichen
  • " ' ( ) + , - . / : ?
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SkipDualWrite

Dieser Parameter ist im lokalen Exchange verfügbar.

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-StateOrProvince

Der Parameter StateOrProvince gibt das Bundesland oder den Kanton des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-StreetAddress

Der Parameter StreetAddress gibt die physische Adresse des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-StsRefreshTokensValidFrom

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

StsRefreshTokensValidFrom gibt das Datum und die Uhrzeit an, ab der die STS-Aktualisierungstoken des Benutzers gültig sind.

Verwenden Sie das unter "Regionale Einstellungen" definierte kurze Datumsformat für den Computer, auf dem der Befehl ausgeführt wird. Wenn auf dem Computer z. B. das kurze Datumsformat TT.MM.JJJJ konfiguriert ist, geben Sie "01.09.2018" ein, um als Datum den 1. September 2018 anzugeben. Sie können entweder nur das Datum oder das Datum und die Uhrzeit angeben. Wenn Sie das Datum und die Uhrzeit eingeben, setzen Sie das den Wert in Anführungszeichen ("), z. B. "09.01.2018 17:00".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-TelephoneAssistant

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter TelephoneAssistant gibt die Telefonnummer des Assistenten des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Title

Der Parameter Title gibt den Titel des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-UMCallingLineIds

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der Parameter UMCallingLineIds gibt die Telefonnummern oder die Durchwahlnummern an, die einem UM-aktivierten (Unified Messaging) Benutzer zugeordnet werden können. Sie können für jeden Benutzer mehrere Telefonnummern angeben, indem Sie sie mit Kommata trennen. Dieser Parameter akzeptiert Ziffern mit einer Länge von weniger als 128 Zeichen und kann ein optionales Pluszeichen (+) vor den Zahlen enthalten. Jeder UM-aktivierte Benutzer muss über einen eindeutigen Wert des Parameters UMCallingLineIds verfügen.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-UMDtmfMap

Dieser Parameter ist im lokalen Exchange verfügbar.

Der UMDtmfMap-Parameter gibt die DTMF-Zuordnungswerte (Dual-Tone Multiple-Frequency) für den Empfänger an. Dadurch kann der Empfänger mithilfe einer Telefontataatur in Unified Messaging-Umgebungen (UM) identifiziert werden. In der Regel werden diese DTMF-Werte automatisch erstellt und aktualisiert, aber Sie können diesen Parameter verwenden, um Änderungen manuell vorzunehmen. Dieser Parameter verwendet die folgende Syntax:

  • emailAddress:<integers>
  • lastNameFirstName:<integers>
  • firstNameLastName:<integers>

Verwenden Sie die folgende Syntax, um Werte einzugeben, die alle vorhandenen Einträge überschreiben: emailAddress:<integers>,lastNameFirstName:<integers>,firstNameLastName:<integers>.

Wenn Sie diese Syntax verwenden und einen der DTMF-Zuordnungswerte weglassen, werden diese Werte aus dem Empfänger entfernt. Wenn Sie beispielsweise nur emailAddress:<integers>angeben, werden alle vorhandenen LastNameFirstName- und firstNameLastName-Werte entfernt.

Verwenden Sie die folgende Syntax, um Werte ohne Auswirkungen auf andere vorhandene Einträge hinzuzufügen oder zu entfernen: @{Add="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"; Remove="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"}.

Wenn Sie diese Syntax verwenden, müssen Sie nicht alle DTMF-Kartenwerte angeben, und Sie können mehrere DTMF-Kartenwerte angeben. Sie können beispielsweise verwenden @{Add="emailAddress:<integers1>","emailAddress:<integers2>} , um zwei neue Werte für emailAddress hinzuzufügen, ohne die vorhandenen LastNameFirstName- und firstNameLastName-Werte zu beeinträchtigen.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-UserPrincipalName

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter UserPrincipalName gibt den Anmeldenamen für das Benutzerkonto an. Der UPN verwendet ein E-Mail-Adressformat: username@domain. In der Regel ist der Domänenwert die Domäne, in der sich das Benutzerkonto befindet.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-VIP

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der VIP-Parameter gibt an, ob der Benutzer ein Prioritätskonto ist. Gültige Werte sind:

  • $true: Der Benutzer ist ein Prioritätskonto.
  • $false: Der Benutzer ist kein Prioritätskonto.

Weitere Informationen zu Prioritätskonten finden Sie unter Verwalten und Überwachen von Prioritätskonten.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-WebPage

Der Parameter WebPage gibt die Webseite des Benutzers an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WhatIf

Die WhatIf-Option funktioniert bei diesem Cmdlet nicht.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WindowsEmailAddress

Der Parameter WindowsEmailAddress gibt die Windows-E-Mail-Adresse für diesen Empfänger an. Dies ist ein allgemeines Active Directory-Attribut, das in allen Umgebungen vorhanden ist, einschließlich Umgebungen ohne Exchange. Die Verwendung des Parameters WindowsEmailAddress für einen Empfänger führt zu einem der folgenden Ergebnisse:

  • In Umgebungen, in denen der Empfänger E-Mail-Adressrichtlinien unterliegt (die EmailAddressPolicyEnabled-Eigenschaft ist für den Empfänger auf den Wert True festgelegt), hat der Parameter WindowsEmailAddress keine Auswirkungen auf die WindowsEmailAddress-Eigenschaft oder den wert primäre E-Mail-Adresse.
  • In Umgebungen, in denen der Empfänger nicht den E-Mail-Adressrichtlinien unterliegt (die EmailAddressPolicyEnabled-Eigenschaft ist für den Empfänger auf den Wert False festgelegt), aktualisiert der Parameter WindowsEmailAddress die WindowsEmailAddress-Eigenschaft und die primäre E-Mail-Adresse auf den gleichen Wert.

Die WindowsEmailAddress-Eigenschaft ist für den Empfänger in Active Directory-Benutzer und -Computer im E-Mail-Attribut sichtbar. Der allgemeine Name des Attributs lautet E-Mail-Adressen, und ldap-Display-Name ist mail. Wenn Sie dieses Attribut in Active Directory ändern, wird die primäre E-Mail-Adresse des Empfängers nicht auf denselben Wert aktualisiert.

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Eingaben

Input types

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.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.