Dela via


Set-CMEmailProfile

SYNOPSIS

Anger en e-postprofil.

SYNTAX

ByValue (standard)

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

Cmdleten Set-CMEmailProfile uppdaterar inställningarna för en e-Exchange ActiveSync profil.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Uppdatera en profil efter namn

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

Det här kommandot uppdaterar namnet på e Exchange ActiveSync profilen från EmailProfile1 till newEmailProfile1.

Exempel 2: Uppdatera en profil efter ID

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

Det här kommandot uppdaterar namnet på e Exchange ActiveSync profilen med ID:t för 16795654 till newEmailProfile2.

Exempel 3: Uppdatera en profil som ett indataobjekt

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

Det första kommandot hämtar Exchange ActiveSync e-postprofilobjektet med namnet EmailProfile3 och lagrar objektet i $EmailProfile variabeln.

Det andra kommandot ändrar namnet på e-postprofilen som lagras i $EmailProfile till newEmailProfile3.

Exempel 4: Använda pipelinen för att uppdatera en profil

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

Det här kommandot hämtar Exchange ActiveSync-postprofilobjektet med namnet EmailProfile4 och använder pipelineoperatorn för att skicka objektet till Set-CMEmailProfile, vilket ändrar namnet på e-postprofilobjektet till newEmailProfile4.

PARAMETERS

-AccountDomainActiveDirectory

Anger typen av Active Directory-kontodomän. Giltiga värden är:

  • domän
  • 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

Anger en anpassad kontodomän. Den här parametern kan bara användas om värdet sAMAccountName har angetts för parametern AccountUserNameType.

Type: String
Parameter Sets: (All)
Aliases:

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

-AccountName

Anger visningsnamnet för e-postkontot.

Type: String
Parameter Sets: (All)
Aliases:

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

-AccountUserNameType

Anger en typ av kontoanvändarnamn. Giltiga värden är:

  • e-post
  • 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

Ange om användare tillåts flytta e-postmeddelanden mellan olika konton som de har konfigurerat på sina enheter.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowThirdPartyApplication

Anger om användare tillåts att skicka e-post från vissa icke-standardprogram för e-post från tredje part.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

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

-Beskrivning

Anger en beskrivning av den Exchange ActiveSync e-postprofilen.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EmailAddressType

Anger en e-postadresstyp. Giltiga värden är:

  • e-post
  • 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

Anger om utgående e-post skickas med S/MIME-kryptering.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Anger CI_ID för en Exchange ActiveSync e-postprofil.

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

Anger ett identitetscertifikatobjekt. Om du vill hämta ett identitetscertifikatobjekt använder du 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

Anger ett Exchange ActiveSync e-postprofilobjekt. Om du vill hämta ett e-postprofilobjekt använder Get-CMEmailProfile-funktionen.

Type: IResultObject
Parameter Sets: ByValue
Aliases:

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

-MailSyncDays

Anger hur många dagars e-post som ska synkroniseras. Giltiga värden är:

  • Obegränsat
  • 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

Anger namnet på en Exchange ActiveSync e-postprofil.

Type: String
Parameter Sets: ByName
Aliases:

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

-NewName

Anger ett nytt namn för en Exchange ActiveSync e-postprofil.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar denna cmdlet kanske inte några utdata.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-SigningCertificate

Anger ett signeringscertifikatobjekt som används för S/MIME-signering. Om du vill hämta ett signeringscertifikatobjekt använder du Get-CMConfigurationPolicy cmdlet.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-SupportedPlatform

Anger de operativsystem där e-postprofilen ska installeras. Om du vill hämta ett plattformsobjekt som stöds använder du 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

Anger en innehållstyp som ska synkroniseras till enheter. Giltiga värden är:

  • Ingen
  • E-post
  • Kontakter
  • Kalender
  • Uppgifter
  • Kommentarer
  • Alla
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

Anger det schema som används för att synkronisera data från Exchange Server.

  • Manuell
  • FifteenMins
  • ThirtyMins
  • Ymins
  • 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

Anger om listan över e-postadresser som nyligen har använts på enheten är synkroniserad.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseSsl

Anger om Secure Sockets Layer (SSL)-kommunikation används för att skicka e-post, ta emot e-post och kommunicera med Exchange Server.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

Get-CMConfigurationPolicy

Get-CMEmailProfile

Get-CMSupportedPlatform

New-CMEmailProfile