sthMailProfile

1.0.1

ru-ru/sthMailProfile.help.ps1xml

<?xml version="1.0" encoding="utf-8"?>
<helpItems schema="maml">
    <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10"
        xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10"
        xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"
        xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
        <command:details>
            <command:name>Send-sthMailMessage</command:name>
            <command:verb>Send</command:verb>
            <command:noun>sthMailMessage</command:noun>
            <maml:description>
                <maml:para>Отправляет сообщение по электронной почте с использованием указанного профиля.
                </maml:para>
            </maml:description>
        </command:details>
        <maml:description>
            <maml:para>Функция Send-sthMailMessage отправляет сообщение по электронной почте с использованием настроек, заданных в указанном профиле.
            </maml:para>
            <maml:para>Вы можете создать профиль при помощи функции New-sthMailProfile.
            </maml:para>
        </maml:description>
        <command:syntax>
            <command:syntaxItem>
                <maml:name>Send-sthMailMessage</maml:name>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="0" aliases="none">
                    <maml:name>Message</maml:name>
                    <maml:Description>
                        <maml:para>Задает тело сообщения электронной почты.
                        </maml:para>
                        <maml:para>Вы можете передать функции Send-sthMailMessage результаты выполнения какой либо другой функции или командлета по конвейеру.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">Object[]</command:parameterValue>
                    <dev:type>
                        <maml:name>Object[]</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none">
                    <maml:name>Subject</maml:name>
                    <maml:Description>
                        <maml:para>Указывает тему сообщения электронной почты.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                    <dev:type>
                        <maml:name>String</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none">
                    <maml:name>ProfileName</maml:name>
                    <maml:Description>
                        <maml:para>Указывает имя профиля.
                        </maml:para>
                        <maml:para>Профили содержат настройки для отправки сообщений электронной почты.
Вы можете создать профиль при помощи функции New-sthMailProfile.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                    <dev:type>
                        <maml:name>String</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none">
                    <maml:name>Attachments</maml:name>
                    <maml:Description>
                        <maml:para>Указывает пути к файлам, которые нужно прикрепить к сообщению электронной почты.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue>
                    <dev:type>
                        <maml:name>String[]</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
            </command:syntaxItem>
        </command:syntax>
        <command:parameters>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="0" aliases="none">
                <maml:name>Message</maml:name>
                <maml:Description>
                    <maml:para>Задает тело сообщения электронной почты.
                    </maml:para>
                    <maml:para>Вы можете передать функции Send-sthMailMessage результаты выполнения какой либо другой функции или командлета по конвейеру.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">Object[]</command:parameterValue>
                <dev:type>
                    <maml:name>Object[]</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none">
                <maml:name>Subject</maml:name>
                <maml:Description>
                    <maml:para>Указывает тему сообщения электронной почты.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                <dev:type>
                    <maml:name>String</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none">
                <maml:name>ProfileName</maml:name>
                <maml:Description>
                    <maml:para>Указывает имя профиля.
                    </maml:para>
                    <maml:para>Профили содержат настройки для отправки сообщений электронной почты.
Вы можете создать профиль при помощи функции New-sthMailProfile.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                <dev:type>
                    <maml:name>String</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="3" aliases="none">
                <maml:name>Attachments</maml:name>
                <maml:Description>
                    <maml:para>Указывает пути к файлам, которые нужно прикрепить к сообщению электронной почты.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue>
                <dev:type>
                    <maml:name>String[]</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
        </command:parameters>
        <maml:AlertSet>
            <maml:Alert>
                <para>Так как SecureString использует DPAPI, то, если вы создаете профиль, содержащий учетные данные (имя и пароль) без использования параметра -StorePasswordInPlainText, этот профиль может быть использован только на том компьютере, на котором он был создан и только под той пользовательской учетной записью, под которой он был создан.</para>
            </maml:Alert>
        </maml:AlertSet>
        <command:examples>
            <command:example>
                <maml:title>Пример 1: Отправка сообщения электронной почты с использованием ранее созданного профиля.</maml:title>
                <dev:code>$ps = Get-Process
Send-sthMailMessage -Message $ps -Subject "Process List" -ProfileName "MailProfile"</dev:code>
                <dev:remarks>
                    <maml:para>Первая команда получает результаты выполнения командлета Get-Process и сохраняет их в переменной $ps.
Вторая команда отправляет их по электронной почте с использованием ранее созданного профиля с именем "MailProfile".</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
            <command:example>
                <maml:title>Пример 2: Отправка сообщения электронной почты с использованием конвейера и ранее созданного профиля.</maml:title>
                <dev:code>Get-Process | Send-sthMailMessage -Subject "Process List" -ProfileName "MailProfile"</dev:code>
                <dev:remarks>
                    <maml:para>Команда получает результаты выполнения командлета Get-Process по конвейеру и отправляет их по электронной почте с использованием ранее созданного профиля с именем "MailProfile".</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
            <command:example>
                <maml:title>Пример 3: Отправка сообщения электронной почты, содержащего прикрепленные файлы, с использованием ранее созданного профиля.</maml:title>
                <dev:code>Get-Process | Send-sthMailMessage -Subject "Process List" -ProfileName "MailProfile" -Attachments "file1.txt, file2.txt"</dev:code>
                <dev:remarks>
                    <maml:para>Команда получает результаты выполнения командлета Get-Process по конвейеру и отправляет их вместе с приложенными файлами по электронной почте с использованием ранее созданного профиля с именем "MailProfile".</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
        </command:examples>
    </command:command>
    <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10"
        xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10"
        xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"
        xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
        <command:details>
            <command:name>New-sthMailProfile</command:name>
            <command:verb>New</command:verb>
            <command:noun>sthMailProfile</command:noun>
            <maml:description>
                <maml:para>Создает профиль электронной почты.
                </maml:para>
            </maml:description>
        </command:details>
        <maml:description>
            <maml:para>Функция New-sthMailProfile создает профиль электронной почты, содержащий указанные параметры.
            </maml:para>
            <maml:para>Профиль - это файл xml, расположенный в каталоге "Profiles", находящемся в папке модуля и содержащий параметры электронной почты, такие как: From, To, Credential, SmtpServer, Port, UseSSL, Encoding, BodyAsHtml, CC, BCC, DeliveryNotificationOption, and Priority.
            </maml:para>
            <maml:para>Профиль используется функцией Send-sthMailMessage.
            </maml:para>
        </maml:description>
        <command:syntax>
            <command:syntaxItem>
                <maml:name>New-sthMailProfile</maml:name>
                <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none">
                    <maml:name>ProfileName</maml:name>
                    <maml:Description>
                        <maml:para>Задает имя профиля.
                        </maml:para>
                        <maml:para>Указанное значение будет использовано в качестве имени файла профиля.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                    <dev:type>
                        <maml:name>String</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none">
                    <maml:name>From</maml:name>
                    <maml:Description>
                        <maml:para>Указывает адрес отправителя. Введите имя (не обязательно) и адрес электронной почты, например: Отправитель &lt;someone@example.com&gt;.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                    <dev:type>
                        <maml:name>String</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none">
                    <maml:name>To</maml:name>
                    <maml:Description>
                        <maml:para>Указывает адрес получателя. Введите имена (не обязательно) и адреса электронной почты, например: Получатель &lt;someone@example.com&gt;.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue>
                    <dev:type>
                        <maml:name>String[]</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>UserName</maml:name>
                    <maml:Description>
                        <maml:para>Указывает имя пользователя, обладающего правами на отправку электронной почты.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                    <dev:type>
                        <maml:name>String</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>Password</maml:name>
                    <maml:Description>
                        <maml:para>Указывает пароль пользователя, имя которого было задано параметром -UserName.
                        </maml:para>
                        <maml:para>Значение параметра может быть строкой или объектом SecureString.
                        </maml:para>
                        <maml:para>Если параметр -UserName был указан, а параметр -Password - нет, то функция запросит его значение.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String or SecureString</command:parameterValue>
                    <dev:type>
                        <maml:name>String or SecureString</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>StorePasswordInPlainText</maml:name>
                    <maml:Description>
                        <maml:para>Указывает, что пароль будет храниться открытым текстом.</maml:para>
                        <maml:para>По умолчанию, пароль шифруется при помощи DPAPI, что означает, что профиль может быть использован только на том компьютере, на котором он был создан и только под той пользовательской учетной записью, под которой он был создан.</maml:para>
                        <maml:para>Если же использован параметр -StorePasswordInPlainText, пароль будет храниться открытым текстом, что позволяет использовать профиль на других компьютерах, а не только на том, где он был создан, а также под иными пользовательскими учетными записями, отличными от той, под которой он был создан.</maml:para>
                    </maml:Description>
                    <dev:type>
                        <maml:name>SwitchParameter</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>False</dev:defaultValue>
                </command:parameter>
                <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>SmtpServer</maml:name>
                    <maml:Description>
                        <maml:para>Указывает имя SMTP-сервера, через который будет отправлено сообщение электронной почты.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                    <dev:type>
                        <maml:name>String</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>Port</maml:name>
                    <maml:Description>
                        <maml:para>Указывает порт SMTP-сервера. По умолчанию используется порт 25.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue>
                    <dev:type>
                        <maml:name>Int32</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>UseSSL</maml:name>
                    <maml:Description>
                        <maml:para>Указывает, что для подключения к SMTP-серверу будет использоваться протокол Secure Sockets Layer (SSL). По умолчанию SSL не используется.
                        </maml:para>
                    </maml:Description>
                    <dev:type>
                        <maml:name>SwitchParameter</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>False</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>Encoding</maml:name>
                    <maml:Description>
                        <maml:para>Указывает кодировку сообщения электронной почты.
                        </maml:para>
                        <maml:para>Вы можете указать как имя кодовой страницы, например 'unicode', так и ее числовое значение, например '1200'.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="false" variableLength="false">String</command:parameterValue>
                    <dev:type>
                        <maml:name>String</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>BodyAsHTML</maml:name>
                    <maml:Description>
                        <maml:para>Указывает, что содержимое сообщения представляет из себя HTML.
                        </maml:para>
                    </maml:Description>
                    <dev:type>
                        <maml:name>SwitchParameter</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>False</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>CC</maml:name>
                    <maml:Description>
                        <maml:para>Указывает адреса электронной почты, на которые будет отправлена копия сообщения.
Введите имена (не обязательно) и адреса электронной почты, например: Получатель &lt;someone@example.com&gt;.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="false" variableLength="false">String[]</command:parameterValue>
                    <dev:type>
                        <maml:name>String[]</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>BCC</maml:name>
                    <maml:Description>
                        <maml:para>Указывает адреса электронной почты, которые получат копию сообщения, однако не будут отображены в качестве получателей.
Введите имена (не обязательно) и адреса электронной почты, например: Получатель &lt;someone@example.com&gt;.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="false" variableLength="false">String[]</command:parameterValue>
                    <dev:type>
                        <maml:name>String[]</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>DeliveryNotificationOption</maml:name>
                    <maml:Description>
                        <maml:para>Задает опции уведомления о доставке для сообщения электронной почты. Вы можете указать несколько значений. Значение по умолчанию - None.
 
Опции уведомления о доставке отправляются в сообщении, отсылаемом на адрес, указанный в значении параметра -To.
 
Допустимые значения параметра:
- None. Без уведомления.
- OnSuccess. Уведомить в случае успешной доставки.
- OnFailure. Уведомить в случае если доставка не удалась.
- Delay. Уведомить, если доставка задерживается.
- Never. Никогда не уведомлять.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="false" variableLength="false">String[]</command:parameterValue>
                    <dev:type>
                        <maml:name>String[]</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>Priority</maml:name>
                    <maml:Description>
                        <maml:para>Указывает приоритет сообщения электронной почты. Значение по умолчанию - Normal.
 
Допустимые значения параметра:
- Normal
- High
- Low
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="false" variableLength="false">String</command:parameterValue>
                    <dev:type>
                        <maml:name>String</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
            </command:syntaxItem>
            <command:syntaxItem>
                <maml:name>New-sthMailProfile</maml:name>
                <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none">
                    <maml:name>ProfileName</maml:name>
                    <maml:Description>
                        <maml:para>Задает имя профиля.
                        </maml:para>
                        <maml:para>Указанное значение будет использовано в качестве имени файла профиля.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                    <dev:type>
                        <maml:name>String</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none">
                    <maml:name>From</maml:name>
                    <maml:Description>
                        <maml:para>Указывает адрес отправителя. Введите имя (не обязательно) и адрес электронной почты, например: Отправитель &lt;someone@example.com&gt;.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                    <dev:type>
                        <maml:name>String</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none">
                    <maml:name>To</maml:name>
                    <maml:Description>
                        <maml:para>Указывает адрес получателя. Введите имена (не обязательно) и адреса электронной почты, например: Получатель &lt;someone@example.com&gt;.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue>
                    <dev:type>
                        <maml:name>String[]</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>Credential</maml:name>
                    <maml:Description>
                        <maml:para>Указывает учетные данные пользователя, обладающего правами на отправку электронной почты.
В качестве значения принимает объект PSCredential.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">PSCredential</command:parameterValue>
                    <dev:type>
                        <maml:name>PSCredential</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>StorePasswordInPlainText</maml:name>
                    <maml:Description>
                        <maml:para>Указывает, что пароль будет храниться открытым текстом.</maml:para>
                        <maml:para>По умолчанию, пароль шифруется при помощи DPAPI, что означает, что профиль может быть использован только на том компьютере, на котором он был создан и только под той пользовательской учетной записью, под которой он был создан.</maml:para>
                        <maml:para>Если же использован параметр -StorePasswordInPlainText, пароль будет храниться открытым текстом, что позволяет использовать профиль на других компьютерах, а не только на том, где он был создан, а также под иными пользовательскими учетными записями, отличными от той, под которой он был создан.</maml:para>
                    </maml:Description>
                    <dev:type>
                        <maml:name>SwitchParameter</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>False</dev:defaultValue>
                </command:parameter>
                <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>SmtpServer</maml:name>
                    <maml:Description>
                        <maml:para>Указывает имя SMTP-сервера, через который будет отправлено сообщение электронной почты.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                    <dev:type>
                        <maml:name>String</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>Port</maml:name>
                    <maml:Description>
                        <maml:para>Указывает порт SMTP-сервера. По умолчанию используется порт 25.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue>
                    <dev:type>
                        <maml:name>Int32</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>UseSSL</maml:name>
                    <maml:Description>
                        <maml:para>Указывает, что для подключения к SMTP-серверу будет использоваться протокол Secure Sockets Layer (SSL). По умолчанию SSL не используется.
                        </maml:para>
                    </maml:Description>
                    <dev:type>
                        <maml:name>SwitchParameter</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>False</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>Encoding</maml:name>
                    <maml:Description>
                        <maml:para>Указывает кодировку сообщения электронной почты.
                        </maml:para>
                        <maml:para>Вы можете указать как имя кодовой страницы, например 'unicode', так и ее числовое значение, например '1200'.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="false" variableLength="false">String</command:parameterValue>
                    <dev:type>
                        <maml:name>String</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>BodyAsHTML</maml:name>
                    <maml:Description>
                        <maml:para>Указывает, что содержимое сообщения представляет из себя HTML.
                        </maml:para>
                    </maml:Description>
                    <dev:type>
                        <maml:name>SwitchParameter</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>False</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>CC</maml:name>
                    <maml:Description>
                        <maml:para>Указывает адреса электронной почты, на которые будет отправлена копия сообщения.
Введите имена (не обязательно) и адреса электронной почты, например: Получатель &lt;someone@example.com&gt;.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="false" variableLength="false">String[]</command:parameterValue>
                    <dev:type>
                        <maml:name>String[]</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>BCC</maml:name>
                    <maml:Description>
                        <maml:para>Указывает адреса электронной почты, которые получат копию сообщения, однако не будут отображены в качестве получателей.
Введите имена (не обязательно) и адреса электронной почты, например: Получатель &lt;someone@example.com&gt;.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="false" variableLength="false">String[]</command:parameterValue>
                    <dev:type>
                        <maml:name>String[]</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>DeliveryNotificationOption</maml:name>
                    <maml:Description>
                        <maml:para>Задает опции уведомления о доставке для сообщения электронной почты. Вы можете указать несколько значений. Значение по умолчанию - None.
 
Опции уведомления о доставке отправляются в сообщении, отсылаемом на адрес, указанный в значении параметра -To.
 
Допустимые значения параметра:
- None. Без уведомления.
- OnSuccess. Уведомить в случае успешной доставки.
- OnFailure. Уведомить в случае если доставка не удалась.
- Delay. Уведомить, если доставка задерживается.
- Never. Никогда не уведомлять.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="false" variableLength="false">String[]</command:parameterValue>
                    <dev:type>
                        <maml:name>String[]</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>Priority</maml:name>
                    <maml:Description>
                        <maml:para>Указывает приоритет сообщения электронной почты. Значение по умолчанию - Normal.
 
Допустимые значения параметра:
- Normal
- High
- Low
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="false" variableLength="false">String</command:parameterValue>
                    <dev:type>
                        <maml:name>String</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
            </command:syntaxItem>
        </command:syntax>
        <command:parameters>
            <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="0" aliases="none">
                <maml:name>ProfileName</maml:name>
                <maml:Description>
                    <maml:para>Задает имя профиля.
                    </maml:para>
                    <maml:para>Указанное значение будет использовано в качестве имени файла профиля.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                <dev:type>
                    <maml:name>String</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="1" aliases="none">
                <maml:name>From</maml:name>
                <maml:Description>
                    <maml:para>Указывает адрес отправителя. Введите имя (не обязательно) и адрес электронной почты, например: Отправитель &lt;someone@example.com&gt;.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                <dev:type>
                    <maml:name>String</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="2" aliases="none">
                <maml:name>To</maml:name>
                <maml:Description>
                    <maml:para>Указывает адрес получателя. Введите имена (не обязательно) и адреса электронной почты, например: Получатель &lt;someone@example.com&gt;.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue>
                <dev:type>
                    <maml:name>String[]</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>UserName</maml:name>
                <maml:Description>
                    <maml:para>Указывает имя пользователя, обладающего правами на отправку электронной почты.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                <dev:type>
                    <maml:name>String</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>Password</maml:name>
                <maml:Description>
                    <maml:para>Указывает пароль пользователя, имя которого было задано параметром -UserName.
                    </maml:para>
                    <maml:para>Значение параметра может быть строкой или объектом SecureString.
                    </maml:para>
                    <maml:para>Если параметр -UserName был указан, а параметр -Password - нет, то функция запросит его значение.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">String or SecureString</command:parameterValue>
                <dev:type>
                    <maml:name>String or SecureString</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>Credential</maml:name>
                <maml:Description>
                    <maml:para>Указывает учетные данные пользователя, обладающего правами на отправку электронной почты.
В качестве значения принимает объект PSCredential.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">PSCredential</command:parameterValue>
                <dev:type>
                    <maml:name>PSCredential</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>StorePasswordInPlainText</maml:name>
                <maml:Description>
                    <maml:para>Указывает, что пароль будет храниться открытым текстом.</maml:para>
                    <maml:para>По умолчанию, пароль шифруется при помощи DPAPI, что означает, что профиль может быть использован только на том компьютере, на котором он был создан и только под той пользовательской учетной записью, под которой он был создан.</maml:para>
                    <maml:para>Если же использован параметр -StorePasswordInPlainText, пароль будет храниться открытым текстом, что позволяет использовать профиль на других компьютерах, а не только на том, где он был создан, а также под иными пользовательскими учетными записями, отличными от той, под которой он был создан.</maml:para>
                </maml:Description>
                <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>
                <dev:type>
                    <maml:name>SwitchParameter</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>False</dev:defaultValue>
            </command:parameter>
            <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>SmtpServer</maml:name>
                <maml:Description>
                    <maml:para>Указывает имя SMTP-сервера, через который будет отправлено сообщение электронной почты.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">String</command:parameterValue>
                <dev:type>
                    <maml:name>String</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>Port</maml:name>
                <maml:Description>
                    <maml:para>Указывает порт SMTP-сервера. По умолчанию используется порт 25.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">Int32</command:parameterValue>
                <dev:type>
                    <maml:name>Int32</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>UseSSL</maml:name>
                <maml:Description>
                    <maml:para>Указывает, что для подключения к SMTP-серверу будет использоваться протокол Secure Sockets Layer (SSL). По умолчанию SSL не используется.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>
                <dev:type>
                    <maml:name>SwitchParameter</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>False</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>Encoding</maml:name>
                <maml:Description>
                    <maml:para>Указывает кодировку сообщения электронной почты.
                    </maml:para>
                    <maml:para>Вы можете указать как имя кодовой страницы, например 'unicode', так и ее числовое значение, например '1200'.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="false" variableLength="false">String</command:parameterValue>
                <dev:type>
                    <maml:name>String</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>BodyAsHTML</maml:name>
                <maml:Description>
                    <maml:para>Указывает, что содержимое сообщения представляет из себя HTML.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>
                <dev:type>
                    <maml:name>SwitchParameter</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>False</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>CC</maml:name>
                <maml:Description>
                    <maml:para>Указывает адреса электронной почты, на которые будет отправлена копия сообщения.
Введите имена (не обязательно) и адреса электронной почты, например: Получатель &lt;someone@example.com&gt;.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="false" variableLength="false">String[]</command:parameterValue>
                <dev:type>
                    <maml:name>String[]</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>BCC</maml:name>
                <maml:Description>
                    <maml:para>Указывает адреса электронной почты, которые получат копию сообщения, однако не будут отображены в качестве получателей.
Введите имена (не обязательно) и адреса электронной почты, например: Получатель &lt;someone@example.com&gt;.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="false" variableLength="false">String[]</command:parameterValue>
                <dev:type>
                    <maml:name>String[]</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>DeliveryNotificationOption</maml:name>
                <maml:Description>
                    <maml:para>Задает опции уведомления о доставке для сообщения электронной почты. Вы можете указать несколько значений. Значение по умолчанию - None.
 
Опции уведомления о доставке отправляются в сообщении, отсылаемом на адрес, указанный в значении параметра -To.
 
Допустимые значения параметра:
- None. Без уведомления.
- OnSuccess. Уведомить в случае успешной доставки.
- OnFailure. Уведомить в случае если доставка не удалась.
- Delay. Уведомить, если доставка задерживается.
- Never. Никогда не уведомлять.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="false" variableLength="false">String</command:parameterValue>
                <dev:type>
                    <maml:name>String</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>Priority</maml:name>
                <maml:Description>
                    <maml:para>Указывает приоритет сообщения электронной почты. Значение по умолчанию - Normal.
 
Допустимые значения параметра:
- Normal
- High
- Low
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="false" variableLength="false">String</command:parameterValue>
                <dev:type>
                    <maml:name>String</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
        </command:parameters>
        <maml:AlertSet>
            <maml:Alert>
                <para>Так как SecureString использует DPAPI, то, если вы создаете профиль, содержащий учетные данные (имя и пароль) без использования параметра -StorePasswordInPlainText, этот профиль может быть использован только на том компьютере, на котором он был создан и только под той пользовательской учетной записью, под которой он был создан.</para>
            </maml:Alert>
        </maml:AlertSet>
        <command:examples>
            <command:example>
                <maml:title>Пример 1: Создание нового профиля.</maml:title>
                <dev:code>New-sthMailProfile -ProfileName "MailProfile" -From source@domain.com -To destination@domain.com -SmtpServer smtp.domain.com</dev:code>
                <dev:remarks>
                    <maml:para>Команда создает профиль электронной почты с именем "MailProfile" и параметрами From, To и SmtpServer.</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
            <command:example>
                <maml:title>Пример 2: Создание нового профиля, содержащего учетные данные.</maml:title>
                <dev:code>New-sthMailProfile -ProfileName "MailProfile" -From source@domain.com -To destination@domain.com -SmtpServer smtp.domain.com -UserName user@domain.com
Type the password:</dev:code>
                <dev:remarks>
                    <maml:para>Команда создает профиль электронной почты с именем "MailProfile" и параметрами From, To, SmtpServer, UserName и Password.
Так как параметр -Password указан не был, функция запрашивает его значение.</maml:para>
                    <maml:para>Так как SecureString использует DPAPI, то, если вы создаете профиль, содержащий учетные данные (имя и пароль) без использования параметра -StorePasswordInPlainText, этот профиль может быть использован только на том компьютере, на котором он был создан и только под той пользовательской учетной записью, под которой он был создан.</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
            <command:example>
                <maml:title>Пример 3: Создание нового профиля с указанием пароля в качестве строки.</maml:title>
                <dev:code>New-sthMailProfile -ProfileName "MailProfile" -From source@domain.com -To destination@domain.com -SmtpServer smtp.domain.com -UserName user@domain.com -Password 'password'</dev:code>
                <dev:remarks>
                    <maml:para>Команда создает профиль электронной почты с именем "MailProfile" и параметрами From, To, SmtpServer, UserName и Password.
Пароль указывается в виде строки.</maml:para>
                    <maml:para>Так как SecureString использует DPAPI, то, если вы создаете профиль, содержащий учетные данные (имя и пароль) без использования параметра -StorePasswordInPlainText, этот профиль может быть использован только на том компьютере, на котором он был создан и только под той пользовательской учетной записью, под которой он был создан.</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
            <command:example>
                <maml:title>Пример 4: Создание нового профиля с указанием пароля в качестве объекта SecureString.</maml:title>
                <dev:code>$Password = ConvertTo-SecureString -String 'password' -AsPlainText -Force
New-sthMailProfile -ProfileName "MailProfile" -From source@domain.com -To destination@domain.com -SmtpServer smtp.domain.com -UserName user@domain.com -Password $Password</dev:code>
                <dev:remarks>
                    <maml:para>Первая команда создает объект SecureString из строки и назначает его переменной $Password.
Вторая команда создает профиль электронной почты с именем "MailProfile" и параметрами From, To, SmtpServer, UserName и Password.
Пароль указывается в виде объекта SecureString.</maml:para>
                    <maml:para>Так как SecureString использует DPAPI, то, если вы создаете профиль, содержащий учетные данные (имя и пароль) без использования параметра -StorePasswordInPlainText, этот профиль может быть использован только на том компьютере, на котором он был создан и только под той пользовательской учетной записью, под которой он был создан.</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
            <command:example>
                <maml:title>Пример 5: Создание нового профиля с использованием объекта PSCredential.</maml:title>
                <dev:code>$Password = ConvertTo-SecureString -String 'password' -AsPlainText -Force
$Credential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList 'UserName', $Password
New-sthMailProfile -ProfileName "MailProfile" -From source@domain.com -To destination@domain.com -SmtpServer smtp.domain.com -Credential $Credential</dev:code>
                <dev:remarks>
                    <maml:para>Первая команда создает объект SecureString из строки и назначает его переменной $Password.
Вторая команда создает объект PSCredential, используя 'UserName' и соданный ранее пароль в качестве аргументов.
Третья команда создает профиль электронной почты с именем "MailProfile" и параметрами From, To, SmtpServer и Credential.</maml:para>
                    <maml:para>Так как SecureString использует DPAPI, то, если вы создаете профиль, содержащий учетные данные (имя и пароль) без использования параметра -StorePasswordInPlainText, этот профиль может быть использован только на том компьютере, на котором он был создан и только под той пользовательской учетной записью, под которой он был создан.</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
            <command:example>
                <maml:title>Пример 6: Создание нового профиля, хранящего пароль открытым текстом.</maml:title>
                <dev:code>New-sthMailProfile -ProfileName "MailProfile" -From source@domain.com -To destination@domain.com -SmtpServer smtp.domain.com -UserName user@domain.com -Password 'password' -StorePasswordInPlainText</dev:code>
                <dev:remarks>
                    <maml:para>Команда создает профиль электронной почты с именем "MailProfile" и параметрами From, To, SmtpServer, UserName и Password.
Так как указан параметр -StorePasswordInPlainText, пароль будет храниться в профиле открытым текстом.
Это позволяет вам использовать профиль на других компьютерах, а не только на том, где он был создан, а также под иными пользовательскими учетными записями, отличными от той, под которой он был создан.</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
        </command:examples>
    </command:command>
    <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10"
        xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10"
        xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"
        xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
        <command:details>
            <command:name>Get-sthMailProfile</command:name>
            <command:verb>Get</command:verb>
            <command:noun>sthMailProfile</command:noun>
            <maml:description>
                <maml:para>Получает существующие профили электронной почты.
                </maml:para>
            </maml:description>
        </command:details>
        <maml:description>
            <maml:para>Функция Get-sthMailProfile получает существующие профили электронной почты и отображает их параметры.
            </maml:para>
            <maml:para>Профиль - это файл xml, расположенный в каталоге "Profiles", находящемся в папке модуля и содержащий параметры электронной почты, такие как: From, To, Credential, SmtpServer, Port, UseSSL, Encoding, BodyAsHtml, CC, BCC, DeliveryNotificationOption, and Priority.
            </maml:para>
            <maml:para>Профиль создается при помощи функции New-sthMailProfile и используется функцией Send-sthMailMessage.
            </maml:para>
        </maml:description>
        <command:syntax>
            <command:syntaxItem>
                <maml:name>Get-sthMailProfile</maml:name>
                <command:parameter required="false" variableLength="true" globbing="true" pipelineInput="False" position="0" aliases="none">
                    <maml:name>ProfileName</maml:name>
                    <maml:Description>
                        <maml:para>Указывает имя профиля.
                        </maml:para>
                        <maml:para>Поддерживается использование символов подстановки.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue>
                    <dev:type>
                        <maml:name>String[]</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
                <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                    <maml:name>ShowPassword</maml:name>
                    <maml:Description>
                <maml:para>Указвыает, что вывод команды должен включать в себя значение пароля.
По умолчанию пароли не отображаются.</maml:para>
                    </maml:Description>
                    <dev:type>
                        <maml:name>SwitchParameter</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>False</dev:defaultValue>
                </command:parameter>
            </command:syntaxItem>
        </command:syntax>
        <command:parameters>
            <command:parameter required="false" variableLength="true" globbing="true" pipelineInput="False" position="0" aliases="none">
                <maml:name>ProfileName</maml:name>
                <maml:Description>
                    <maml:para>Указывает имя профиля.
                    </maml:para>
                    <maml:para>Поддерживается использование символов подстановки.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue>
                <dev:type>
                    <maml:name>String[]</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
            <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
                <maml:name>ShowPassword</maml:name>
                <maml:Description>
                <maml:para>Указвыает, что вывод команды должен включать в себя значение пароля.
По умолчанию пароли не отображаются.</maml:para>
                </maml:Description>
                <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>
                <dev:type>
                    <maml:name>SwitchParameter</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>False</dev:defaultValue>
            </command:parameter>
        </command:parameters>
        <maml:AlertSet>
            <maml:Alert>
                <para>Свойство PasswordIs может принимать одно из трех значений: NotExist, PlainText и Secured.
NotExist означает, что профиль не содержит учетных данных.
PlainText означает, что пароль хранится в профиле открытым текстом.
Secured означает, что пароль хранится в зашифрованном виде.
 
Так как SecureString использует DPAPI, то, если вы создаете профиль, содержащий учетные данные (имя и пароль) без использования параметра -StorePasswordInPlainText, этот профиль может быть использован только на том компьютере, на котором он был создан и только под той пользовательской учетной записью, под которой он был создан.</para>
            </maml:Alert>
        </maml:AlertSet>
        <command:examples>
            <command:example>
                <maml:title>Пример 1: Получение всех существующих профилей.</maml:title>
                <dev:code>Get-sthMailProfile
                 
ProfileName : MailProfile
From : source@domain.com
To : {destination@domain.com}
PasswordIs : NotExist
SmtpServer : smtp.domain.com
 
ProfileName : MailProfile2
From : source@domain.com
To : {destination@domain.com}
UserName : user@domain.com
PasswordIs : PlainText
SmtpServer : smtp.domain.com
 
ProfileName : MailProfile3
From : source@domain.com
To : {destination@domain.com}
UserName : user@domain.com
PasswordIs : Secured
SmtpServer : smtp.domain.com</dev:code>
                <dev:remarks>
                    <maml:para>Команда получает все существующие профили и отображает их параметры.</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
            <command:example>
                <maml:title>Пример 2: Получение профиля с определенным именем.</maml:title>
                <dev:code>Get-sthMailProfile MailProfile
 
ProfileName : MailProfile
From : source@domain.com
To : {destination@domain.com}
PasswordIs : NotExist
SmtpServer : smtp.domain.com</dev:code>
                <dev:remarks>
                    <maml:para>Команда получает профиль "MailProfile" и отображает его параметры.</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
            <command:example>
                <maml:title>Пример 3: Получение профилей с использованием символов подстановки.</maml:title>
                <dev:code>Get-sthMailProfile -ProfileName "Mail*"
                 
ProfileName : MailProfile
From : source@domain.com
To : {destination@domain.com}
PasswordIs : NotExist
SmtpServer : smtp.domain.com
 
ProfileName : MailProfile2
From : source@domain.com
To : {destination@domain.com}
UserName : user@domain.com
PasswordIs : PlainText
SmtpServer : smtp.domain.com
 
ProfileName : MailProfile3
From : source@domain.com
To : {destination@domain.com}
UserName : user@domain.com
PasswordIs : Secured
SmtpServer : smtp.domain.com</dev:code>
                <dev:remarks>
                    <maml:para>Команда получает профили с именами, начинающимися с "Mail" и отображает их параметры.</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
            <command:example>
                <maml:title>Пример 4: Получение профилей и отображение их параметров, в том числе пароля.</maml:title>
                <dev:code>Get-sthMailProfile -ShowPassword
                 
ProfileName : MailProfile
From : source@domain.com
To : {destination@domain.com}
PasswordIs : NotExist
SmtpServer : smtp.domain.com
 
ProfileName : MailProfile2
From : source@domain.com
To : {destination@domain.com}
UserName : user@domain.com
Password : password
PasswordIs : PlainText
SmtpServer : smtp.domain.com
 
ProfileName : MailProfile3
From : source@domain.com
To : {destination@domain.com}
UserName : user@domain.com
Password : password
PasswordIs : Secured
SmtpServer : smtp.domain.com</dev:code>
                <dev:remarks>
                    <maml:para>Команда получает существующие профили и отображает все их параметры, в том числе пароль.</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
        </command:examples>
    </command:command>
    <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10"
        xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10"
        xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10"
        xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
        <command:details>
            <command:name>Remove-sthMailProfile</command:name>
            <command:verb>Remove</command:verb>
            <command:noun>sthMailProfile</command:noun>
            <maml:description>
                <maml:para>Удаляет профили электронной почты.
                </maml:para>
            </maml:description>
        </command:details>
        <maml:description>
            <maml:para>Функция Remove-sthMailProfile удаляет указанные профили электронной почты.
            </maml:para>
            <maml:para>Профиль - это файл xml, расположенный в каталоге "Profiles", находящемся в папке модуля и содержащий параметры электронной почты, такие как: From, To, Credential, SmtpServer, Port, UseSSL, Encoding, BodyAsHtml, CC, BCC, DeliveryNotificationOption, and Priority.
            </maml:para>
            <maml:para>Профиль создается при помощи функции New-sthMailProfile и используется функцией Send-sthMailMessage.
            </maml:para>
        </maml:description>
        <command:syntax>
            <command:syntaxItem>
                <maml:name>Remove-sthMailProfile</maml:name>
                <command:parameter required="true" variableLength="true" globbing="true" pipelineInput="False" position="0" aliases="none">
                    <maml:name>ProfileName</maml:name>
                    <maml:Description>
                        <maml:para>Указывает имя профиля для удаления.
                        </maml:para>
                        <maml:para>Поддерживается использование символов подстановки.
                        </maml:para>
                    </maml:Description>
                    <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue>
                    <dev:type>
                        <maml:name>String[]</maml:name>
                        <maml:uri />
                    </dev:type>
                    <dev:defaultValue>None</dev:defaultValue>
                </command:parameter>
            </command:syntaxItem>
        </command:syntax>
        <command:parameters>
            <command:parameter required="true" variableLength="true" globbing="true" pipelineInput="False" position="0" aliases="none">
                <maml:name>ProfileName</maml:name>
                <maml:Description>
                    <maml:para>Указывает имя профиля для удаления.
                    </maml:para>
                    <maml:para>Поддерживается использование символов подстановки.
                    </maml:para>
                </maml:Description>
                <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue>
                <dev:type>
                    <maml:name>String[]</maml:name>
                    <maml:uri />
                </dev:type>
                <dev:defaultValue>None</dev:defaultValue>
            </command:parameter>
        </command:parameters>
        <command:examples>
            <command:example>
                <maml:title>Пример 1: Удаление профиля.</maml:title>
                <dev:code>Remove-sthMailProfile -ProfileName "MailProfile"</dev:code>
                <dev:remarks>
                    <maml:para>Команда удаляет профиль "MailProfile".</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
            <command:example>
                <maml:title>Пример 2: Удаление профилей с использованием символов подстановки.</maml:title>
                <dev:code>Remove-sthMailProfile -ProfileName "Mail*"</dev:code>
                <dev:remarks>
                    <maml:para>Команда удаляет профили с именами, начинающимися с "Mail".</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
            <command:example>
                <maml:title>Пример 3: Удаление всех профилей.</maml:title>
                <dev:code>Remove-sthMailProfile -ProfileName *</dev:code>
                <dev:remarks>
                    <maml:para>Команда удаляет все профили.</maml:para>
                    <maml:para/>
                    <maml:para/>
                </dev:remarks>
            </command:example>
        </command:examples>
    </command:command>
</helpItems>