Set-CMEmailProfile
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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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 namens 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 die 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
| Type: | String |
| Accepted values: | domain, ntdomain |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AccountName
Gibt den Anzeigenamen für das E-Mail-Konto an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AccountUserNameType
Gibt einen Kontobenutzernamenstyp an. Gültige Werte sind:
- Samaccountname
- userPrincipalName
| Type: | String |
| Accepted values: | mail, sAMAccountName, userPrincipalName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowMessageMove
Geben Sie an, ob Benutzer E-Mail-Nachrichten zwischen verschiedenen Konten verschieben dürfen, die sie auf ihrem Gerät konfiguriert haben.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowThirdPartyApplication
Gibt an, ob Benutzer E-Mails von bestimmten nicht standardmäßigen E-Mail-Anwendungen von Drittanbietern senden dürfen.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Gibt eine Beschreibung für das Exchange ActiveSync E-Mail-Profil an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EmailAddressType
Gibt einen E-Mail-Adresstyp an. Gültige Werte sind:
- userPrincipalName
| Type: | String |
| Accepted values: | mail, userPrincipalName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableSmime
Gibt an, ob ausgehende E-Mails mit S/MIME-Verschlüsselung gesendet werden.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Gibt die CI_ID für ein Exchange ActiveSync-E-Mail-Profil an.
| Type: | Int32 |
| Aliases: | CI_ID, CIId |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdentityCertificate
Gibt ein Identitätszertifikatobjekt an. Verwenden Sie das Cmdlet Get-CMConfigurationPolicy, um ein Identitätszertifikatobjekt abzurufen.
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Gibt ein Exchange ActiveSync E-Mail-Profilobjekt an. Verwenden Sie die Funktion Get-CMEmailProfile, um ein E-Mail-Profilobjekt abzurufen.
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MailSyncDays
Gibt die Anzahl der Tage der zu synchronisierenden E-Mail an. Gültige Werte sind:
- Unbegrenzt
- Oneday
- ThreeDays
- OneWeek
- Zwei Wochen
- OneMonth
| Type: | MailNumberofDaysToSync |
| Accepted values: | Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Gibt den Namen eines Exchange ActiveSync E-Mail-Profils an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Gibt einen neuen Namen für ein Exchange ActiveSync E-Mail-Profil an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | IResultObject[] |
| Aliases: | SupportedPlatforms |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SyncContentType
Gibt einen Inhaltstyp an, der mit Geräten synchronisiert werden soll. Gültige Werte sind:
- Keine
- E-Mails
- Kontakte
- Kalender
- Aufgaben
- Anmerkungen
- Alle
| Type: | EasProfileSyncContentType |
| Aliases: | SyncContentTypes |
| Accepted values: | None, Email, Contacts, Calendar, Tasks, Notes, All |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SynchronizeRecentlyUsed
Gibt an, ob die Liste der E-Mail-Adressen, die kürzlich auf dem Gerät verwendet wurden, synchronisiert wird.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SyncSchedule
Gibt den Zeitplan an, nach dem Geräte Daten aus dem Exchange Server synchronisieren.
- Manual
- FifteenMins
- ThirtyMins
- SixtyMins
- AsArrive
| Type: | Schedule |
| Accepted values: | Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseSsl
Gibt an, ob SSL-Kommunikation (Secure Sockets Layer) beim Senden von E-Mails, empfangen von E-Mails und beim Kommunizieren mit dem Exchange Server verwendet wird.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object
Ähnliche Themen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für