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.