Различия

Показаны различия между двумя версиями страницы.

--- microsoft-windows:windows-server-2012-r2:adds:how-to-use-managed-service-accounts-msa-and-group-managed-service-account-gmsa:how-to-create-a-windows-scheduler-task-on-behalf-of-msa-gmsa-in-powershell [06.06.2019 17:53] – создано Алексей Максимов
+++ microsoft-windows:windows-server-2012-r2:adds:how-to-use-managed-service-accounts-msa-and-group-managed-service-account-gmsa:how-to-create-a-windows-scheduler-task-on-behalf-of-msa-gmsa-in-powershell [13.10.2019 11:02] (текущий) – Алексей Максимов
@@ Строка 1: / Строка 1: @@
-===== Как создать задание планировщика Windows от имени учётной записи MSA/gMSA в PowerShell =====
+===== Как создать задание Планировщика Windows Task Scheduler от имени учётной записи MSA/gMSA в PowerShell =====
+{{:microsoft-windows:windows-server-2012-r2:adds:how-to-use-managed-service-accounts-msa-and-group-managed-service-account-gmsa:pasted:20190606-212754.png }} Графическая оболочка Планировщика заданий **Windows Task Scheduler** в ОС **Windows Server 2012 R2** не умеет работать с учётными записями **MSA**/**gMSA**. Однако для настройки задания планировщика Windows, которое должно выполняться от имени сервисной учётной записи MSA/gMSA, мы можем воспользоваться возможностями оболочки  **PowerShell**.
+\\
+==== Создание простого задания ====
+Запустим оболочку PowerShell __с правами Администратора__ и создадим простое задание планировщика Windows для запуска некоторого PS-скрипта с ежедневным выполнением, например в 23:00:
+<HTML><pre><span style="color: #800080;">$Action</span><span style="color: #000000;"> </span><span style="color: #FF0000;">=</span><span style="color: #000000;"> </span><span style="color: #5F9EA0;">New-ScheduledTaskAction</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Execute</span><span style="color: #000000;"> </span><span style="color: #800000;">"</span><span style="color: #800000;">PowerShell.exe</span><span style="color: #800000;">"</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-weight: bold;">`</span><span style="color: #000000;">
+ </span><span style="color: #5F9EA0; font-style: italic;">-Argument</span><span style="color: #000000;"> </span><span style="color: #800000;">"</span><span style="color: #800000;">-NoProfile -command `"D:\FBInst1\Tools\FBBases-Backup.ps1`"</span><span style="color: #800000;">"</span><span style="color: #000000;">
+</span><span style="color: #800080;">$Trigger</span><span style="color: #000000;"> </span><span style="color: #FF0000;">=</span><span style="color: #000000;"> </span><span style="color: #5F9EA0;">New-ScheduledTaskTrigger</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Daily</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-At</span><span style="color: #000000;"> </span><span style="color: #000000;">23</span><span style="color: #000000;">:</span><span style="color: #000000;">00</span><span style="color: #000000;">
+</span><span style="color: #800080;">$SvcUser</span><span style="color: #000000;"> </span><span style="color: #FF0000;">=</span><span style="color: #000000;"> </span><span style="color: #5F9EA0;">New-ScheduledTaskPrincipal</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-UserID</span><span style="color: #000000;"> </span><span style="color: #800000;">KOM\s</span><span style="color: #000000;">-S11$ </span><span style="color: #5F9EA0; font-style: italic;">-LogonType</span><span style="color: #000000;"> </span><span style="color: #800000;">Password</span><span style="color: #000000;">
+</span><span style="color: #5F9EA0;">Register-ScheduledTask</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-TaskName</span><span style="color: #000000;"> </span><span style="color: #800000;">"</span><span style="color: #800000;">Firebird DBs (Instance1) Backup</span><span style="color: #800000;">"</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-weight: bold;">`</span><span style="color: #000000;">
+</span><span style="color: #5F9EA0; font-style: italic;">-Action</span><span style="color: #000000;"> </span><span style="color: #800080;">$Action</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Trigger</span><span style="color: #000000;"> </span><span style="color: #800080;">$Trigger</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Principal</span><span style="color: #000000;"> </span><span style="color: #800080;">$SvcUser</span></pre></HTML>
+{{ :microsoft-windows:windows-server-2012-r2:adds:how-to-use-managed-service-accounts-msa-and-group-managed-service-account-gmsa:pasted:20190606-214042.png }}
+Откроем графическую консоль управления планировщиком Windows и проверим корректность созданного задания.
+{{ :microsoft-windows:windows-server-2012-r2:adds:how-to-use-managed-service-accounts-msa-and-group-managed-service-account-gmsa:pasted:20190606-214116.png }}
+\\
+==== Изменение созданного задания ====
+В случае необходимости изменения созданного задания с использованием учётной записи MSA/gMSA не нужно пытаться изменить здание через графическую консоль, так как это приведёт к запросам аутентификации для учётной записи gMSA и ошибкам сохранения задания. Изменить созданное задание можно с помощью PowerShell. Например, чтобы изменить время запуска задания можем выполнить следующий код:
+<HTML><pre><span style="color: #800080;">$Trigger</span><span style="color: #000000;"> </span><span style="color: #FF0000;">=</span><span style="color: #000000;"> </span><span style="color: #5F9EA0;">New-ScheduledTaskTrigger</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Daily</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-At</span><span style="color: #000000;"> </span><span style="color: #000000;">23</span><span style="color: #000000;">:</span><span style="color: #000000;">05</span><span style="color: #000000;">
+</span><span style="color: #5F9EA0;">Set-ScheduledTask</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-TaskName</span><span style="color: #000000;"> </span><span style="color: #800000;">"</span><span style="color: #800000;">Firebird DBs (Instance1) Backup</span><span style="color: #800000;">"</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Trigger</span><span style="color: #000000;"> </span><span style="color: #800080;">$Trigger</span></pre></HTML>
+{{ :microsoft-windows:windows-server-2012-r2:adds:how-to-use-managed-service-accounts-msa-and-group-managed-service-account-gmsa:pasted:20190606-214326.png }}
+\\
+==== Задания со сложным расписанием ====
+Рассмотрим ещё один пример создания задачи планировщика, но уже с более сложным расписанием выполнения. Например, нам нужно,  чтобы задание выполнялось дважды в день в определённое время. В этом случае в качестве значения триггера используется массив объектов, созданных командлетом **New-ScheduledTaskTrigger**. Например, задача, выполняемая ежедневно утром и вечером в определённое время может быть создана так:
+<HTML><pre><span style="color: #800080;">$Action</span><span style="color: #000000;"> </span><span style="color: #FF0000;">=</span><span style="color: #000000;"> </span><span style="color: #5F9EA0;">New-ScheduledTaskAction</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Execute</span><span style="color: #000000;"> </span><span style="color: #800000;">"</span><span style="color: #800000;">C:\Programms\MyProgramm.exe</span><span style="color: #800000;">"</span><span style="color: #000000;">
+</span><span style="color: #800080;">$Trigger</span><span style="color: #000000;"> </span><span style="color: #FF0000;">=</span><span style="color: #000000;"> @(
+    $(</span><span style="color: #5F9EA0;">New-ScheduledTaskTrigger</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Daily</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-At</span><span style="color: #000000;"> </span><span style="color: #000000;">8</span><span style="color: #000000;">:</span><span style="color: #000000;">30</span><span style="color: #000000;">),
+    $(</span><span style="color: #5F9EA0;">New-ScheduledTaskTrigger</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Daily</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-At</span><span style="color: #000000;"> </span><span style="color: #000000;">20</span><span style="color: #000000;">:</span><span style="color: #000000;">30</span><span style="color: #000000;">)
+)
+</span><span style="color: #800080;">$SvcUser</span><span style="color: #000000;"> </span><span style="color: #FF0000;">=</span><span style="color: #000000;"> </span><span style="color: #5F9EA0;">New-ScheduledTaskPrincipal</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-UserID</span><span style="color: #000000;"> </span><span style="color: #800000;">DOMAIN\gMSAAccount</span><span style="color: #000000;">$ </span><span style="color: #5F9EA0; font-style: italic;">-LogonType</span><span style="color: #000000;"> </span><span style="color: #800000;">Password</span><span style="color: #000000;">
+</span><span style="color: #800080;">$TDescription</span><span style="color: #000000;"> </span><span style="color: #FF0000;">=</span><span style="color: #000000;"> </span><span style="color: #800000;">'</span><span style="color: #800000;">Описание моей задачи</span><span style="color: #800000;">'</span><span style="color: #000000;">
+</span><span style="color: #5F9EA0;">Register-ScheduledTask</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-TaskName</span><span style="color: #000000;"> </span><span style="color: #800000;">"</span><span style="color: #800000;">My Task</span><span style="color: #800000;">"</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-TaskPath</span><span style="color: #000000;"> </span><span style="color: #800000;">"</span><span style="color: #800000;">\My Tasks</span><span style="color: #800000;">"</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Action</span><span style="color: #000000;"> </span><span style="color: #800080;">$Action</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-weight: bold;">`</span><span style="color: #000000;">
+</span><span style="color: #5F9EA0; font-style: italic;">-Trigger</span><span style="color: #000000;"> </span><span style="color: #800080;">$Trigger</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Principal</span><span style="color: #000000;"> </span><span style="color: #800080;">$SvcUser</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Description</span><span style="color: #000000;"> </span><span style="color: #800080;">$TDescription</span></pre></HTML>
+Если требуется постоянный цикличный запуск задания, например, каждые 5 минут, то значение триггера можно задать следующим образом:
+<HTML><pre><span style="color: #800080;">$Trigger</span><span style="color: #000000;"> </span><span style="color: #FF0000;">=</span><span style="color: #000000;"> </span><span style="color: #5F9EA0;">New-ScheduledTaskTrigger</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-weight: bold;">`</span><span style="color: #000000;">
+    </span><span style="color: #5F9EA0; font-style: italic;">-Once</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-weight: bold;">`</span><span style="color: #000000;">
+    </span><span style="color: #5F9EA0; font-style: italic;">-At</span><span style="color: #000000;"> (</span><span style="color: #5F9EA0; font-weight: bold;">Get-Date</span><span style="color: #000000;">) </span><span style="color: #5F9EA0; font-weight: bold;">`</span><span style="color: #000000;">
+    </span><span style="color: #5F9EA0; font-style: italic;">-RepetitionInterval</span><span style="color: #000000;"> (</span><span style="color: #5F9EA0; font-weight: bold;">New-TimeSpan</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Minutes</span><span style="color: #000000;"> </span><span style="color: #000000;">5</span><span style="color: #000000;">) </span><span style="color: #5F9EA0; font-weight: bold;">`</span><span style="color: #000000;">
+    </span><span style="color: #5F9EA0; font-style: italic;">-RepetitionDuration</span><span style="color: #000000;"> ([</span><span style="color: #008080;">System.TimeSpan</span><span style="color: #000000;">]::</span><span style="color: #8B4513;">MaxValue</span><span style="color: #000000;">)</span></pre></HTML>
+Ещё один пример указания триггера с условием, что задание должно выполняться в определённое время, но только по рабочим дням недели:
+<HTML><pre><span style="color: #800080;">$Trigger</span><span style="color: #000000;"> </span><span style="color: #FF0000;">=</span><span style="color: #000000;"> </span><span style="color: #5F9EA0;">New-ScheduledTaskTrigger</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-style: italic;">-Weekly</span><span style="color: #000000;"> </span><span style="color: #5F9EA0; font-weight: bold;">`</span><span style="color: #000000;">
+</span><span style="color: #5F9EA0; font-style: italic;">-DaysOfWeek</span><span style="color: #000000;"> Monday,Tuesday,Wednesday,Thursday,Friday </span><span style="color: #5F9EA0; font-style: italic;">-At</span><span style="color: #000000;"> </span><span style="color: #000000;">9</span><span style="color: #000000;">:</span><span style="color: #000000;">10</span></pre></HTML>
+\\
+==== Триггер -AtStartup ====
+При создании заданий Планировщика с триггером по запуску ОС (-AtStartup) может потребоваться дополнительно установить в свойствах триггера небольшую задержку по времени для того, чтобы дать возможность завершения инициализации механизмов доменной аутентификации. Пример такой настройки рассмотрен [[https://blog.it-kb.ru/2019/10/13/running-hpe-product-bulletin-gateway-in-group-managed-service-account-gmsa-account-context-with-windows-task-scheduler/|здесь]].
+<HTML><pre><span style="color: #008000;">#</span><span style="color: #008000;"> Добавляем в первый триггер задания Планировщика 3-минутную задержку перед запуском</span><span style="color: #008000;">
+#</span><span style="color: #008000;"> А также отключаем ограничение времени выполнения задания</span><span style="color: #008000;">
+#</span><span style="color: #008000;"> Формат указания длительности времени https://en.wikipedia.org/wiki/ISO_8601#Durations </span><span style="color: #008000;">
+#
+</span><span style="color: #800080;">$Task</span><span style="color: #000000;">.Triggers[0].Delay </span><span style="color: #FF0000;">=</span><span style="color: #000000;"> </span><span style="color: #800000;">"</span><span style="color: #800000;">PT3M</span><span style="color: #800000;">"</span><span style="color: #000000;">
+</span><span style="color: #800080;">$Task</span><span style="color: #000000;">.Settings.ExecutionTimeLimit </span><span style="color: #FF0000;">=</span><span style="color: #000000;"> </span><span style="color: #800000;">"</span><span style="color: #800000;">PT0S</span><span style="color: #800000;">"</span><span style="color: #000000;">
+</span><span style="color: #800080;">$Task</span><span style="color: #000000;"> | </span><span style="color: #5F9EA0;">Set-ScheduledTask</span></pre></HTML>
 ----