Freigeben über

New-CMEmailProfile

  • Referenz
Modul:
ConfigurationManager

Erstellt ein E-Mail-Profil.

Syntax

New-CMEmailProfile
   [-AccountDomainActiveDirectory <String>]
   [-AccountDomainCustom <String>]
   -AccountName <String>
   [-AccountUserNameType <String>]
   [-AllowMessageMove]
   [-AllowThirdPartyApplication]
   [-Description <String>]
   [-DoNotUseSsl]
   [-EmailAddressType <String>]
   [-EnableSmime]
   -ExchangeHost <String>
   [-IdentityCertificate <IResultObject>]
   [-MailSyncDays <MailNumberofDaysToSync>]
   -Name <String>
   [-SigningCertificate <IResultObject>]
   -SupportedPlatform <IResultObject[]>
   [-SyncContentType <EasProfileSyncContentType>]
   [-SynchronizeRecentlyUsed]
   [-SyncSchedule <Schedule>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-CMEmailProfile erstellt ein Exchange ActiveSync-E-Mail-Profil.

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: Erstellen eines E-Mail-Profils

PS XYZ:\> $Platform = Get-CMSupportedPlatform -Fast -Platform "Windows Phone"
PS XYZ:\> New-CMEmailProfile -AccountName "TestAccount1" -ExchangeHost "TestHost1" -Name "EmailProfile01" -SupportedPlatform $Platform[1] -AccountUserNameType sAMAccountName -AccountDomainActiveDirectory domain

Der erste Befehl ruft alle unterstützten Plattformobjekte für Windows Phone ab und speichert die Objekte in der variablen $Platform.

Der zweite Befehl erstellt eine E-Mail mit dem Namen EmailProfile01 mithilfe des zweiten unterstützten Plattformobjekts aus $Platform.

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:True
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

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

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

-AllowThirdPartyApplication

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

Typ:SwitchParameter
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

-DoNotUseSsl

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

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, dass ausgehende E-Mails mit S/MIME-Verschlüsselung gesendet werden.

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

-ExchangeHost

Gibt den Hostnamen des Exchange-Servers an, auf dem Exchange ActiveSync-Dienste gehostet werden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
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

-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

-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 einen Namen für das Exchange ActiveSync-E-Mail-Profil an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
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:True
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, dass die Liste der E-Mail-Adressen, die kürzlich auf dem Gerät verwendet wurden, synchronisiert wird.

Typ:SwitchParameter
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

-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

None

Ausgaben

IResultObject