Restart-Computer
Перезапуск операционной системы на локальных и удаленных компьютерах.
Синтаксис
Restart-Computer
[-WsmanAuthentication <String>]
[[-ComputerName] <String[]>]
[[-Credential]<PSCredential>]
[-Force]
[-Wait]
[-Timeout <Int32>]
[-For <WaitForServiceTypes>]
[-Delay <Int16>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Описание
Этот командлет доступен только на платформе Windows.
Командлет Restart-Computer перезапускает операционную систему на локальных и удаленных компьютерах.
Параметры Restart-Computer можно использовать для выполнения операций перезапуска, указания уровней проверки подлинности и альтернативных учетных данных, ограничения операций, выполняемых одновременно, и принудительного немедленного перезапуска.
Начиная с Windows PowerShell 3.0, вы можете ждать завершения перезагрузки перед выполнением следующей команды. Укажите интервал ожидания ожидания и интервал запроса и дождитесь доступности определенных служб на перезагруженном компьютере. Эта функция делает его практическим для использования Restart-Computer в скриптах и функциях.
Примеры
Пример 1. Перезапуск локального компьютера
Restart-Computer перезапускает локальный компьютер.
Restart-ComputerПример 2. Перезапуск нескольких компьютеров
Restart-Computer может перезапустить удаленные и локальные компьютеры. Параметр ComputerName принимает массив имен компьютеров.
Restart-Computer -ComputerName Server01, Server02, localhostПример 3. Получение имен компьютеров из текстового файла
Restart-Computer получает список имен компьютеров из текстового файла и перезапускает компьютеры. Параметр ComputerName не указан. Но так как это первый параметр позиции, он принимает имена компьютеров из текстового файла, отправляемого по конвейеру.
Get-Content -Path C:\Domain01.txt | Restart-ComputerGet-Contentиспользует параметр Path для получения списка имен компьютеров из текстового файла Domain01.txt. Имена компьютеров отправляются по конвейеру. Restart-Computer перезапускает каждый компьютер.
Пример 4. Принудительное перезапуска компьютеров, перечисленных в текстовом файле
В этом примере выполняется немедленный перезапуск компьютеров, перечисленных в Domain01.txt файле. Имена компьютеров из текстового файла хранятся в переменной. Параметр Force вызывает немедленный перезапуск.
$Names = Get-Content -Path C:\Domain01.txt
$Creds = Get-Credential
Restart-Computer -ComputerName $Names -Credential $Creds -ForceGet-Contentиспользует параметр Path для получения списка имен компьютеров из текстового файла Domain01.txt. Имена компьютеров хранятся в переменной $Names. Get-Credential запрашивает имя пользователя и пароль и сохраняет значения в переменной $Creds. Restart-Computerиспользует параметры ComputerName и Credential со своими переменными. Параметр Force приводит к немедленному перезапуску каждого компьютера.
Пример 6. Перезагрузка удаленного компьютера и ожидание powerShell
Restart-Computer перезапускает удаленный компьютер, а затем ожидает до 5 минут (300 секунд) для того, чтобы PowerShell стал доступным на перезагрузленном компьютере, прежде чем он продолжит работу.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2Restart-Computerиспользует параметр ComputerName для указания Server01. Параметр wait ожидает завершения перезагрузки. Параметр For указывает, что PowerShell может выполнять команды на удаленном компьютере. Параметр Timeout задает пятиминутное ожидание. Параметр "Задержка " запрашивает удаленный компьютер каждые две секунды, чтобы определить, перезапускается ли он.
Пример 7. Перезапуск компьютера с помощью WsmanAuthentication
Restart-Computer перезапускает удаленный компьютер с помощью механизма WsmanAuthentication .
Проверка подлинности Kerberos определяет, имеет ли текущий пользователь разрешение на перезапуск удаленного компьютера. Дополнительные сведения см. в разделе AuthenticationMechanism.
Restart-Computer -ComputerName Server01 -WsmanAuthentication KerberosRestart-Computerиспользует параметр ComputerName для указания удаленного компьютера Server01.
Параметр WsmanAuthentication указывает метод проверки подлинности как Kerberos.
Параметры
-ComputerName
Указывает одно имя компьютера или разделенный запятыми массив имен компьютеров. Restart-Computerпринимает объекты ComputerName из конвейера или переменных.
Введите имя NetBIOS, IP-адрес или полное доменное имя удаленного компьютера. Чтобы указать локальный компьютер, введите имя компьютера, точку .или localhost.
Этот параметр не зависит от удаленного взаимодействия PowerShell. Параметр ComputerName можно использовать, даже если компьютер не настроен для выполнения удаленных команд.
Если параметр ComputerName не указан, Restart-Computer перезагрузит локальный компьютер.
| Type: | String[] |
| Aliases: | CN, __SERVER, Server, IPAddress |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Запрашивает подтверждение перед выполнением Restart-Computer.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Указывает учетную запись пользователя, которая имеет разрешение на выполнение этого действия. По умолчанию используется текущий пользователь.
Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential, созданный командлетомGet-Credential. Если ввести имя пользователя, вам будет предложено ввести пароль.
Учетные данные хранятся в объекте PSCredential , а пароль хранится как SecureString.
Примечание.
Дополнительные сведения о защите данных SecureString см. в разделе "Как безопасна Защита SecureString?".
| Type: | PSCredential |
| Position: | 1 |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Delay
Указывает частоту запросов в секундах. PowerShell запрашивает службу, указанную параметром For , чтобы определить, доступна ли служба после перезагрузки компьютера.
Этот параметр действителен только вместе с параметрами Wait и For .
Этот параметр впервые появился в Windows PowerShell 3.0.
Если параметр Delay не указан, Restart-Computer используется пять секунд задержки.
| Type: | Int16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-For
Указывает поведение PowerShell по мере ожидания доступности указанной службы или компонента после перезагрузки компьютера. Этот параметр действителен только с параметром Wait .
Допустимые значения для этого параметра:
- По умолчанию: ожидает перезапуска PowerShell.
- PowerShell: может выполнять команды в удаленном сеансе PowerShell на компьютере.
- WMI: получает ответ на запрос Win32_ComputerSystem компьютера.
- WinRM: может установить удаленный сеанс на компьютере с помощью WS-Management.
Этот параметр впервые появился в Windows PowerShell 3.0.
| Type: | WaitForServiceTypes |
| Accepted values: | Wmi, WinRM, PowerShell |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Принудительно перезагрузит компьютер немедленно.
| Type: | SwitchParameter |
| Aliases: | f |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Timeout
Указывает время ожидания в секундах. Когда истекает время ожидания, вернется в командную строку, Restart-Computer даже если компьютеры не перезагрузились.
Параметр Timeout действителен только с параметром Wait . Время ожидания переопределяет неопределенный период ожидания параметра Wait .
Этот параметр впервые появился в Windows PowerShell 3.0.
| Type: | Int32 |
| Aliases: | TimeoutSec |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Wait
Restart-Computer подавляет запрос PowerShell и блокирует конвейер до перезапуска компьютеров. Этот параметр можно использовать в скрипте для перезагрузки компьютеров, а затем продолжить обработку после завершения перезагрузки.
Параметр wait ожидает неограниченное время перезапуска компьютеров. Время ожидания можно использовать для настройки времени и параметров for and Delay, чтобы ждать, пока определенные службы будут доступны на перезагруженных компьютерах.
Параметр Wait недействителен при перезапуске локального компьютера. Если значение параметра ComputerName содержит имена удаленных компьютеров и локального компьютера, Restart-Computer создается несрочная ошибка ожидания на локальном компьютере, но ожидает перезапуска удаленных компьютеров.
Этот параметр впервые появился в Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет, если выполняется Restart-Computer . Командлет Restart-Computer не выполняется.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WsmanAuthentication
Указывает механизм, используемый для проверки подлинности учетных данных пользователя. Этот параметр впервые появился в Windows PowerShell 3.0.
Допустимые значения для этого параметра: Basic, CredSSP, Default, Digest, Kerberos и Negotiate.
Дополнительные сведения см. в разделе AuthenticationMechanism.
Предупреждение
Проверка подлинности поставщика служб безопасности учетных данных (CredSSP), в которой учетные данные пользователя передаются на удаленный компьютер для проверки подлинности, предназначена для команд, требующих проверки подлинности на нескольких ресурсах, таких как доступ к удаленному сетевому ресурсу. Этот механизм повышает риск безопасности удаленной операции. Если удаленный компьютер скомпрометирован, учетные данные, передаваемые ему, могут использоваться для управления сетевым сеансом.
| Type: | String |
| Accepted values: | Basic, CredSSP, Default, Digest, Kerberos, Negotiate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
Можно передать строку, содержащую имя компьютера в этот командлет.
Выходные данные
None
Этот командлет не возвращает выходные данные.
Примечания
- В Windows
Restart-Computerиспользуется метод Win32Shutdown класса инструментария управления Windows (WMI) Win32_OperatingSystem . Для этого метода требуется включить привилегию SeShutdownPrivilege для учетной записи пользователя, используемой для перезапуска компьютера. - В Linux и Mac OS
Restart-Computerиспользуется/sbin/shutdownсредство bash.
Связанные ссылки
PowerShell
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по