Freigeben über

Set-CMEmailProfile

  • Referenz
Modul:
ConfigurationManager

Legt ein E-Mail-Profil fest.

Syntax

Set-CMEmailProfile
   [-AccountDomainActiveDirectory <String>]
   [-AccountDomainCustom <String>]
   [-AccountName <String>]
   [-AccountUserNameType <String>]
   [-AllowMessageMove <Boolean>]
   [-AllowThirdPartyApplication <Boolean>]
   [-Description <String>]
   [-EmailAddressType <String>]
   [-EnableSmime <Boolean>]
   [-IdentityCertificate <IResultObject>]
   -InputObject <IResultObject>
   [-MailSyncDays <MailNumberofDaysToSync>]
   [-NewName <String>]
   [-PassThru]
   [-SigningCertificate <IResultObject>]
   [-SupportedPlatform <IResultObject[]>]
   [-SyncContentType <EasProfileSyncContentType>]
   [-SynchronizeRecentlyUsed <Boolean>]
   [-SyncSchedule <Schedule>]
   [-UseSsl <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMEmailProfile
   [-AccountDomainActiveDirectory <String>]
   [-AccountDomainCustom <String>]
   [-AccountName <String>]
   [-AccountUserNameType <String>]
   [-AllowMessageMove <Boolean>]
   [-AllowThirdPartyApplication <Boolean>]
   [-Description <String>]
   [-EmailAddressType <String>]
   [-EnableSmime <Boolean>]
   -Id <Int32>
   [-IdentityCertificate <IResultObject>]
   [-MailSyncDays <MailNumberofDaysToSync>]
   [-NewName <String>]
   [-PassThru]
   [-SigningCertificate <IResultObject>]
   [-SupportedPlatform <IResultObject[]>]
   [-SyncContentType <EasProfileSyncContentType>]
   [-SynchronizeRecentlyUsed <Boolean>]
   [-SyncSchedule <Schedule>]
   [-UseSsl <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMEmailProfile
   [-AccountDomainActiveDirectory <String>]
   [-AccountDomainCustom <String>]
   [-AccountName <String>]
   [-AccountUserNameType <String>]
   [-AllowMessageMove <Boolean>]
   [-AllowThirdPartyApplication <Boolean>]
   [-Description <String>]
   [-EmailAddressType <String>]
   [-EnableSmime <Boolean>]
   [-IdentityCertificate <IResultObject>]
   [-MailSyncDays <MailNumberofDaysToSync>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-SigningCertificate <IResultObject>]
   [-SupportedPlatform <IResultObject[]>]
   [-SyncContentType <EasProfileSyncContentType>]
   [-SynchronizeRecentlyUsed <Boolean>]
   [-SyncSchedule <Schedule>]
   [-UseSsl <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-CMEmailProfile aktualisiert die Einstellungen eines Exchange ActiveSync-E-Mail-Profils.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Aktualisieren eines Profils anhand des Namens

PS XYZ:\> Set-CMEmailProfile -Name "EmailProfile1" -NewName "newEmailProfile1"

Dieser Befehl aktualisiert den Namen des Exchange ActiveSync-E-Mail-Profils von EmailProfile1 in newEmailProfile1.

Beispiel 2: Aktualisieren eines Profils nach ID

PS XYZ:\> Set-CMEmailProfile -Id 16795654 -NewName "newEmailProfile2"

Dieser Befehl aktualisiert den Namen des Exchange ActiveSync-E-Mail-Profils mit der ID von 16795654 in newEmailProfile2.

Beispiel 3: Aktualisieren eines Profils als Eingabeobjekt

PS XYZ:\> $EmailProfile = Get-CMEmailProfile -Name "EmailProfile3"
PS XYZ:\> Set-CMEmailProfile -InputObject $EmailProfile -NewName "newEmailProfile3"

Der erste Befehl ruft das Exchange ActiveSync-E-Mail-Profilobjekt mit dem Namen EmailProfile3 ab und speichert das Objekt in der variablen $EmailProfile.

Der zweite Befehl ändert den Namen des in $EmailProfile gespeicherten E-Mail-Profils in newEmailProfile3.

Beispiel 4: Verwenden der Pipeline zum Aktualisieren eines Profils

PS XYZ:\> Get-CMEmailProfile -Name "EmailProfile4" | Set-CMEmailProfile -NewName "newEmailProfile4"

Dieser Befehl ruft das Exchange ActiveSync-E-Mail-Profilobjekt mit dem Namen EmailProfile4 ab und verwendet den Pipelineoperator, um das Objekt an Set-CMEmailProfile zu übergeben, wodurch der Name des E-Mail-Profilobjekts in newEmailProfile4 geändert wird.

Parameter

-AccountDomainActiveDirectory

Gibt den Typ der Active Directory-Kontodomäne an. Gültige Werte sind:

  • domain
  • ntdomain
Typ:String
Zulässige Werte:domain, ntdomain
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AccountDomainCustom

Gibt eine benutzerdefinierte Kontodomäne an. Dieser Parameter kann nur verwendet werden, wenn der sAMAccountName-Wert für den AccountUserNameType-Parameter angegeben ist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AccountName

Gibt den Anzeigenamen für das E-Mail-Konto an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AccountUserNameType

Gibt einen Kontobenutzernamenstyp an. Gültige Werte sind:

  • mail
  • sAMAccountName
  • userPrincipalName
Typ:String
Zulässige Werte:mail, sAMAccountName, userPrincipalName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllowMessageMove

Geben Sie an, ob Benutzer E-Mail-Nachrichten zwischen verschiedenen Konten verschieben dürfen, die sie auf ihrem Gerät konfiguriert haben.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllowThirdPartyApplication

Gibt an, ob Benutzer E-Mails von bestimmten nicht standardmäßigen E-Mail-Anwendungen von Drittanbietern senden dürfen.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für das Exchange ActiveSync-E-Mail-Profil an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EmailAddressType

Gibt einen E-Mail-Adresstyp an. Gültige Werte sind:

  • mail
  • userPrincipalName
Typ:String
Zulässige Werte:mail, userPrincipalName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableSmime

Gibt an, ob ausgehende E-Mails mit S/MIME-Verschlüsselung gesendet werden.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Gibt die CI_ID für ein Exchange ActiveSync-E-Mail-Profil an.

Typ:Int32
Aliase:CI_ID, CIId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IdentityCertificate

Gibt ein Identitätszertifikatobjekt an. Verwenden Sie das Cmdlet Get-CMConfigurationPolicy, um ein Identitätszertifikatobjekt abzurufen.

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein Exchange ActiveSync-E-Mail-Profilobjekt an. Verwenden Sie zum Abrufen eines E-Mail-Profilobjekts die funktion Get-CMEmailProfile.

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-MailSyncDays

Gibt die Anzahl der Tage der zu synchronisierenden E-Mail an. Gültige Werte sind:

  • Unbegrenzt
  • OneDay
  • ThreeDays
  • OneWeek
  • Zwei Wochen
  • OneMonth
Typ:MailNumberofDaysToSync
Zulässige Werte:Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines Exchange ActiveSync-E-Mail-Profils an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NewName

Gibt einen neuen Namen für ein Exchange ActiveSync-E-Mail-Profil an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SigningCertificate

Gibt ein Signaturzertifikatobjekt an, das für die S/MIME-Signatur verwendet wird. Verwenden Sie das Cmdlet Get-CMConfigurationPolicy, um ein Signaturzertifikatobjekt abzurufen.

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SupportedPlatform

Gibt die Betriebssysteme an, auf denen das E-Mail-Profil installiert wird. Verwenden Sie das Cmdlet Get-CMSupportedPlatform, um ein unterstütztes Plattformobjekt abzurufen.

Typ:IResultObject[]
Aliase:SupportedPlatforms
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SyncContentType

Gibt einen Inhaltstyp an, der mit Geräten synchronisiert werden soll. Gültige Werte sind:

  • Keine
  • E-Mail
  • Kontakte
  • Kalender
  • Aufgaben
  • Anmerkungen
  • Alle
Typ:EasProfileSyncContentType
Aliase:SyncContentTypes
Zulässige Werte:None, Email, Contacts, Calendar, Tasks, Notes, All
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SynchronizeRecentlyUsed

Gibt an, ob die Liste der E-Mail-Adressen, die kürzlich auf dem Gerät verwendet wurden, synchronisiert wird.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SyncSchedule

Gibt den Zeitplan an, nach dem Geräte Daten vom Exchange-Server synchronisieren.

  • Manuell
  • FifteenMins
  • ThirtyMins
  • SixtyMins
  • AsArrive
Typ:Schedule
Zulässige Werte:Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UseSsl

Gibt an, ob SSL-Kommunikation (Secure Sockets Layer) verwendet wird, wenn E-Mails gesendet, E-Mails empfangen und mit Exchange Server kommunizieren.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object