Set-CMEmailProfile
SYNOPSIS
Nastaví e-mailový profil.
SYNTAX
ByValue (výchozí)
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
rutina Set-CMEmailProfile aktualizuje nastavení e-mailového profilu protokol Exchange ActiveSync.
Poznámka
Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: Aktualizace profilu podle názvu
PS XYZ:\> Set-CMEmailProfile -Name "EmailProfile1" -NewName "newEmailProfile1"
tento příkaz aktualizuje název protokol Exchange ActiveSync e-mailového profilu z EmailProfile1 na newEmailProfile1.
Příklad 2: Aktualizace profilu podle ID
PS XYZ:\> Set-CMEmailProfile -Id 16795654 -NewName "newEmailProfile2"
tento příkaz aktualizuje název protokol Exchange ActiveSync e-mailového profilu s ID 16795654 na newEmailProfile2.
Příklad 3: Aktualizace profilu jako vstupního objektu
PS XYZ:\> $EmailProfile = Get-CMEmailProfile -Name "EmailProfile3"
PS XYZ:\> Set-CMEmailProfile -InputObject $EmailProfile -NewName "newEmailProfile3"
první příkaz získá objekt protokol Exchange ActiveSync e-mailového profilu s názvem EmailProfile3 a uloží objekt do proměnné $EmailProfile.
Druhý příkaz změní název e-mailového profilu, který je uložený v $EmailProfile, do newEmailProfile3.
Příklad 4: použití kanálu k aktualizaci profilu
PS XYZ:\> Get-CMEmailProfile -Name "EmailProfile4" | Set-CMEmailProfile -NewName "newEmailProfile4"
tento příkaz získá objekt protokol Exchange ActiveSync e-mailového profilu s názvem EmailProfile4 a pomocí operátoru kanálu předáte objektu Set-CMEmailProfile, který změní název objektu e-mailového profilu na newEmailProfile4.
PARAMETERS
-AccountDomainActiveDirectory
Určuje typ domény účtu služby Active Directory. Platné hodnoty jsou:
- doména
- 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
Určuje vlastní doménu účtu. Tento parametr lze použít pouze v případě, že je pro parametr AccountUserNameType zadána hodnota sAMAccountName.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Account
Určuje zobrazovaný název e-mailového účtu.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AccountUserNameType
Určuje typ uživatelského jména účtu. Platné hodnoty jsou:
- pošta
- sAMAccountName
- userPrincipalName (Hlavní název uživatele)
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
Určuje, jestli uživatelé můžou přesouvat e-mailové zprávy mezi různými účty, které na svém zařízení nakonfigurovali.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowThirdPartyApplication
Určuje, jestli uživatelé můžou posílat e-maily z některých nevýchozích e-mailových aplikací od jiných výrobců.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Description
určuje popis protokol Exchange ActiveSync e-mailového profilu.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EmailAddressType
Určuje typ e-mailové adresy. Platné hodnoty jsou:
- pošta
- userPrincipalName (Hlavní název uživatele)
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
Určuje, jestli se odchozí e-mail posílá pomocí šifrování S/MIME.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučujeme). Nejde kombinovat s DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– ID
určuje CI_ID pro protokol Exchange ActiveSync e-mailový profil.
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
Určuje objekt certifikátu identity. Chcete-li získat objekt certifikátu identity, použijte rutinu Get-CMConfigurationPolicy.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– Položky InputObject
určuje protokol Exchange ActiveSync objekt profilu e-mailu. Chcete-li získat objekt e-mailového profilu, použijte funkci Get-CMEmailProfile.
Type: IResultObject
Parameter Sets: ByValue
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-MailSyncDays
Určuje počet dní, po které se má e-mail synchronizovat. Platné hodnoty jsou:
- Unlimited
- 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
určuje název e-mailového profilu protokol Exchange ActiveSync.
Type: String
Parameter Sets: ByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
určuje nový název protokol Exchange ActiveSync e-mailového profilu.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– PassThru
Přidejte tento parametr pro vrácení objektu, který představuje položku, se kterou pracujete. Ve výchozím nastavení tato rutina nemusí generovat žádný výstup.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SigningCertificate
Určuje objekt podpisového certifikátu, který se používá pro podepisování S/MIME. K získání objektu podpisového certifikátu použijte rutinu Get-CMConfigurationPolicy.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SupportedPlatform
Určuje operační systémy, ve kterých se má e-mailový profil nainstalovat. Chcete-li získat podporovaný objekt platformy, použijte rutinu Get-CMSupportedPlatform.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: SupportedPlatforms
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SyncContentType
Určuje typ obsahu, který se bude synchronizovat se zařízeními. Platné hodnoty jsou:
- Žádná
- Kontakty
- Kalendář
- Úkoly
- Poznámky
- Vše
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
Určuje plán, podle kterého budou zařízení synchronizovat data z Exchange Server.
- Ruční
- FifteenMins
- ThirtyMins (30 minut)
- 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
Určuje, jestli je seznam e-mailových adres, které se v zařízení nedávno použily, synchronizovaný.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseSsl
Určuje, jestli SSL (Secure Sockets Layer) (SSL) se používá při odesílání a přijímání e-mailů a komunikaci s Exchange Server.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespouštěl.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.