Udostępnij za pośrednictwem

Set-CMEmailProfile

  • Artykuł

SYNOPSIS

Ustawia profil poczty e-mail.

SYNTAX

ByValue (wartość domyślna)

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

WedługNazwa

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

Polecenie cmdlet Set-CMEmailProfile aktualizuje ustawienia profilu Exchange ActiveSync poczty e-mail.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: aktualizowanie profilu według nazwy

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

To polecenie aktualizuje nazwę profilu poczty e-Exchange ActiveSync e-mail z EmailProfile1 do newEmailProfile1.

Przykład 2: aktualizowanie profilu według identyfikatora

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

To polecenie aktualizuje nazwę profilu poczty Exchange ActiveSync e-mail o identyfikatorze 16795654 do newEmailProfile2.

Przykład 3: aktualizowanie profilu jako obiektu wejściowego

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

Pierwsze polecenie pobiera obiekt Exchange ActiveSync poczty e-mail o nazwie EmailProfile3 i zapisuje obiekt w zmiennej $EmailProfile poczty e-mail.

Drugie polecenie zmienia nazwę profilu poczty e-mail przechowywanego w pliku $EmailProfile na newEmailProfile3.

Przykład 4. Aktualizowanie profilu przy użyciu potoku

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

To polecenie pobiera obiekt profilu poczty e-mail Exchange ActiveSync o nazwie EmailProfile4 i używa operatora potoku do przekazania obiektu do polecenia Set-CMEmailProfile, które zmienia nazwę obiektu profilu poczty e-mail na newEmailProfile4.

PARAMETERS

-AccountDomainActiveDirectory

Określa typ domeny konta usługi Active Directory. Prawidłowe wartości:

  • domena
  • 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

Określa domenę konta niestandardowego. Tego parametru można użyć tylko wtedy, gdy wartość sAMAccountName jest określona dla parametru AccountUserNameType.

Type: String
Parameter Sets: (All)
Aliases:

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

-AccountName (Nazwa konta)

Określa nazwę wyświetlaną konta e-mail.

Type: String
Parameter Sets: (All)
Aliases:

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

-AccountUserNameType

Określa typ nazwy użytkownika konta. Prawidłowe wartości:

  • mail (poczta)
  • 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

Wskaż, czy użytkownicy mogą przenosić wiadomości e-mail między różnymi kontami skonfigurowanymi na urządzeniu.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowThirdPartyApplication

Wskazuje, czy użytkownicy mogą wysyłać wiadomości e-mail z niektórych innych niż domyślne aplikacji poczty e-mail innych firm.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-Description (Opis)

Określa opis profilu Exchange ActiveSync e-mail.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EmailAddressType

Określa typ adresu e-mail. Prawidłowe wartości:

  • mail (poczta)
  • 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

Wskazuje, czy wychodząca wiadomość e-mail jest wysyłana przy użyciu szyfrowania S/MIME.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id (Identyfikator)

Określa CI_ID dla profilu Exchange ActiveSync poczty e-mail.

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

Określa obiekt certyfikatu tożsamości. Aby uzyskać obiekt certyfikatu tożsamości, użyj 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

Określa obiekt Exchange ActiveSync poczty e-mail. Aby uzyskać obiekt profilu poczty e-mail, użyj Get-CMEmailProfile poczty e-mail.

Type: IResultObject
Parameter Sets: ByValue
Aliases:

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

-MailSyncDays

Określa liczbę dni, przez które mają być synchronizowane wiadomości e-mail. Prawidłowe wartości:

  • Nieograniczona liczba
  • OneDay
  • ThreeDays (Trzy dni)
  • OneWeek
  • TwoWeeks (Dwa tygodnie)
  • 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

Określa nazwę profilu poczty e-Exchange ActiveSync e-mail.

Type: String
Parameter Sets: ByName
Aliases:

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

-NewName

Określa nową nazwę profilu Exchange ActiveSync poczty e-mail.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Dodaj ten parametr, aby zwrócić obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet może nie generować żadnych danych wyjściowych.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-SigningCertificate

Określa obiekt certyfikatu podpisywania używany do podpisywania S/MIME. Aby uzyskać obiekt certyfikatu podpisywania, użyj 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 (ObsługiwanyPlatforma)

Określa systemy operacyjne, w których zostanie zainstalowany profil poczty e-mail. Aby uzyskać obsługiwany obiekt platformy, użyj 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

Określa typ zawartości do zsynchronizowania z urządzeniami. Prawidłowe wartości:

  • Brak
  • E-mail
  • Kontakty
  • Kalendarz
  • Zadania
  • Uwagi
  • Wszystko
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

Określa harmonogram, według którego urządzenia będą synchronizować dane z Exchange Server.

  • Ręcznie
  • FifteenMins
  • ThirtyMins
  • SixtyMins
  • 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

Wskazuje, czy lista adresów e-mail, które były ostatnio używane na urządzeniu, jest zsynchronizowana.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseSsl

Wskazuje, czy Secure Sockets Layer (SSL) jest używana podczas wysyłania i odbierania wiadomości e-mail oraz komunikacji z Exchange Server.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

UWAGI

Get-CMConfigurationPolicy

Get-CMEmailProfile

Get-CMSupportedPlatform

New-CMEmailProfile