Delen via


Set-CMEmailProfile

SYNOPSIS

Hiermee stelt u een e-mailprofiel in.

SYNTAX

ByValue (standaard)

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>]

ById

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>]

ByName

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>]

DESCRIPTION

Met de cmdlet Set-CMEmailProfile worden de instellingen van een e-mailprofiel voor Exchange ActiveSync bijgewerkt.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een profiel bijwerken op naam

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

Met deze opdracht wordt de naam van het e-mailprofiel voor Exchange ActiveSync bijgewerkt van EmailProfile1 naar newEmailProfile1.

Voorbeeld 2: Een profiel bijwerken op id

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

Met deze opdracht wordt de naam van het e-mailprofiel voor Exchange ActiveSync bijgewerkt met de id 16795654 naar newEmailProfile2.

Voorbeeld 3: Een profiel bijwerken als een invoerobject

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

Met de eerste opdracht wordt het e-mailprofielobject voor Exchange ActiveSync met de naam EmailProfile3 op de hoogte gehouden en wordt het object op de $EmailProfile op slaat.

Met de tweede opdracht wordt de naam van het e-mailprofiel dat is opgeslagen in $EmailProfile gewijzigd in newEmailProfile3.

Voorbeeld 4: De pijplijn gebruiken om een profiel bij te werken

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

Met deze opdracht wordt het e-mailprofielobject voor Exchange ActiveSync met de naam EmailProfile4 en wordt de pijplijnoperator gebruikt om het object door te geven aan Set-CMEmailProfile, waarmee de naam van het e-mailprofielobject wordt gewijzigd in newEmailProfile4.

PARAMETERS

-AccountDomainActiveDirectory

Hiermee geeft u het type Active Directory-accountdomein op. Geldige waarden zijn:

  • domein
  • ntdomain
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: domain, ntdomain

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AccountDomainCustom

Hiermee geeft u een aangepast accountdomein. Deze parameter kan alleen worden gebruikt als de waarde sAMAccountName is opgegeven voor de parameter AccountUserNameType.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AccountName

Hiermee geeft u de weergavenaam voor het e-mailaccount op.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AccountUserNameType

Hiermee geeft u een gebruikersnaamtype account. Geldige waarden zijn:

  • mail
  • sAMAccountName
  • userPrincipalName
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: mail, sAMAccountName, userPrincipalName

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllowMessageMove

Geef aan of gebruikers e-mailberichten mogen verplaatsen tussen verschillende accounts die ze op hun apparaat hebben geconfigureerd.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllowThirdPartyApplication

Geeft aan of gebruikers e-mail mogen verzenden vanuit bepaalde niet-standaard e-mailtoepassingen van derden.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Beschrijving

Hiermee geeft u een beschrijving op voor het e-mailprofiel voor Exchange ActiveSync.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EmailAddressType

Hiermee geeft u een e-mailadrestype. Geldige waarden zijn:

  • mail
  • userPrincipalName
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: mail, userPrincipalName

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableSmime

Geeft aan of uitgaande e-mail wordt verzonden met S/MIME-versleuteling.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Id

Hiermee geeft u de CI_ID voor een e-mailprofiel voor Exchange ActiveSync.

Type: Int32
Parameter Sets: ById
Aliases: CI_ID, CIId

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IdentityCertificate

Hiermee geeft u een certificaatobject voor identiteit. Als u een object voor een identiteitscertificaat wilt verkrijgen, gebruikt Get-CMConfigurationPolicy cmdlet .

Type: IResultObject
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Hiermee geeft u een e-mailprofielobject voor Exchange ActiveSync op. Als u een e-mailprofielobject wilt verkrijgen, gebruikt u Get-CMEmailProfile functie.

Type: IResultObject
Parameter Sets: ByValue
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-MailSyncDays

Hiermee geeft u het aantal dagen aan e-mail op dat moet worden gesynchroniseerd. Geldige waarden zijn:

  • Onbeperkt
  • OneDay
  • ThreeDays
  • OneWeek
  • TwoWeeks
  • OneMonth
Type: MailNumberofDaysToSync
Parameter Sets: (All)
Aliases:
Accepted values: Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Hiermee geeft u de naam van een e-mailprofiel voor Exchange ActiveSync op.

Type: String
Parameter Sets: ByName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-NewName

Hiermee geeft u een nieuwe naam op voor een e-mailprofiel voor Exchange ActiveSync.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PassThru

Voeg deze parameter toe om een -object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SigningCertificate

Hiermee geeft u een handtekeningcertificaatobject op dat wordt gebruikt voor S/MIME-ondertekening. Als u een handtekeningcertificaatobject wilt verkrijgen, gebruikt u de cmdlet Get-CMConfigurationPolicy handtekeningcertificaat.

Type: IResultObject
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SupportedPlatform

Hiermee geeft u de besturingssystemen op waarop het e-mailprofiel wordt geïnstalleerd. Als u een ondersteund platformobject wilt verkrijgen, gebruikt u Get-CMSupportedPlatform cmdlet .

Type: IResultObject[]
Parameter Sets: (All)
Aliases: SupportedPlatforms

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SyncContentType

Hiermee geeft u een inhoudstype om te synchroniseren met apparaten. Geldige waarden zijn:

  • Geen
  • E-mail
  • Contactpersonen
  • Kalender
  • Taken
  • Notities
  • Alles
Type: EasProfileSyncContentType
Parameter Sets: (All)
Aliases: SyncContentTypes
Accepted values: None, Email, Contacts, Calendar, Tasks, Notes, All

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SyncSchedule

Hiermee geeft u het schema op waarmee apparaten gegevens van de Exchange-server synchroniseren.

  • Handmatig
  • Vijftienmins
  • ThirtyMins
  • 16Mins
  • AsArrive
Type: Schedule
Parameter Sets: (All)
Aliases:
Accepted values: Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SynchronizeRecentlyUsed

Geeft aan of de lijst met e-mailadressen die onlangs op het apparaat zijn gebruikt, is gesynchroniseerd.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseSsl

Geeft aan of Secure Sockets Layer communicatie (SSL) wordt gebruikt bij het verzenden van e-mailberichten, het ontvangen van e-mailberichten en het communiceren met de Exchange Server.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

Get-CMConfigurationPolicy

Get-CMEmailProfile

Get-CMSupportedPlatform

New-CMEmailProfile