Stop-Computer
Останавливает (завершает работу) локальных и удаленных компьютеров.
Синтаксис
All
Stop-Computer
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-Impersonation <ImpersonationLevel>]
[-ThrottleLimit <Int32>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Stop-Computer завершает работу локального компьютера и удаленных компьютеров.
Параметры Stop-Computer можно использовать для выполнения операций завершения работы в качестве фонового задания, для указания уровней проверки подлинности и альтернативных учетных данных, чтобы ограничить одновременные подключения, созданные для выполнения команды, и принудительное завершение работы.
Этот командлет не требует удаленного взаимодействия PowerShell, если вы не используете параметр AsJob.
Примеры
Пример 1. Завершение работы локального компьютера
В этом примере выполняется завершение работы локального компьютера.
Stop-Computer -ComputerName localhost
Пример 2. Завершение работы двух удаленных компьютеров и локального компьютера
В этом примере останавливается два удаленных компьютера и локальный компьютер.
Stop-Computer -ComputerName "Server01", "Server02", "localhost"
Stop-Computer использует параметр ComputerName для указания двух удаленных компьютеров и локального компьютера. Каждый компьютер завершает работу.
Пример 3. Завершение работы удаленных компьютеров в качестве фонового задания
В этом примере Stop-Computer выполняется в качестве фонового задания на двух удаленных компьютерах.
$j = Stop-Computer -ComputerName "Server01", "Server02" -AsJob
$results = $j | Receive-Job
$results
Stop-Computer использует параметр ComputerName для указания двух удаленных компьютеров. Параметр AsJob выполняет команду в качестве фонового задания. Объекты задания хранятся в переменной $j.
Объекты задания в переменной $j отправляются по конвейеру в Receive-Job, которая получает результаты задания. Объекты хранятся в переменной $results. Переменная $results отображает сведения о задании в консоли PowerShell.
Так как AsJob создает задание на локальном компьютере и автоматически возвращает результаты на локальный компьютер, вы можете запустить Receive-Job в качестве локальной команды.
Пример 4. Завершение работы удаленного компьютера
В этом примере выполняется завершение работы удаленного компьютера с помощью указанной проверки подлинности.
Stop-Computer -ComputerName "Server01" -Impersonation Anonymous -DcomAuthentication PacketIntegrity
Stop-Computer использует параметр ComputerName для указания удаленного компьютера. Параметр олицетворения указывает настраиваемое олицетворение, а параметр DcomAuthentication указывает параметры уровня проверки подлинности.
Пример 5. Завершение работы компьютеров в домене
В этом примере команды принудительно завершают работу всех компьютеров в указанном домене.
$s = Get-Content -Path ./Domain01.txt
$c = Get-Credential -Credential Domain01\Admin01
Stop-Computer -ComputerName $s -Force -ThrottleLimit 10 -Credential $c
Get-Content использует параметр пути для получения файла в текущем каталоге со списком компьютеров домена. Объекты хранятся в переменной $s.
Get-Credential использует параметр учетных данных для указания учетных данных администратора домена. Учетные данные хранятся в переменной $c.
Stop-Computer завершает работу компьютеров, указанных в списке параметров ComputerName в переменной $s. Параметр Force вызывает немедленное завершение работы. Параметр ThrottleLimit ограничивает команду до 10 одновременных подключений. Параметр Credential отправляет учетные данные, сохраненные в переменной $c.
Параметры
-AsJob
Указывает, что этот командлет выполняется в качестве фонового задания.
Чтобы использовать этот параметр, локальные и удаленные компьютеры должны быть настроены для удаленного взаимодействия, а в Windows Vista и более поздних версиях операционной системы Windows необходимо открыть PowerShell с помощью параметра запуска от имени администратора. Дополнительные сведения см. в about_Remote_Requirements.
При указании параметра asJob Receive-Job.
Дополнительные сведения о фоновых заданиях PowerShell см. в about_Jobs и about_Remote_Jobs.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ComputerName
Указывает компьютеры, которые нужно остановить. По умолчанию используется локальный компьютер.
Введите имя NETBIOS, IP-адрес или полное доменное имя одного или нескольких компьютеров в списке, разделенном запятыми. Чтобы указать локальный компьютер, введите имя компьютера или localhost.
Этот параметр не зависит от удаленного управления PowerShell. Вы можете использовать параметр ComputerName, даже если компьютер не настроен для выполнения удаленных команд.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Китай, __СЕРВЕР, Сервер, IP-адрес |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает учетную запись пользователя, которая имеет разрешение на выполнение этого действия. По умолчанию используется текущий пользователь.
Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential, созданный командлетом Get-Credential. Если ввести имя пользователя, вам будет предложено ввести пароль.
Учетные данные хранятся в объекте PSCredential, а пароль хранится в виде SecureString.
Замечание
Дополнительные сведения о защите данных SecureString см. в разделе Как безопасно SecureString?.
Свойства параметров
| Тип: | PSCredential |
| Default value: | Current user |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DcomAuthentication
Указывает уровень проверки подлинности, используемый этим командлетом с WMI.
Stop-Computer использует WMI. Значение по умолчанию — пакетной.
Допустимые значения для этого параметра:
- по умолчанию: проверка подлинности Windows.
- Нет: нет проверки подлинности COM.
- Connect: проверка подлинности COM на уровне подключения.
- вызов: проверка подлинности COM на уровне вызовов.
- пакет: проверка подлинности COM на уровне пакетов.
- PacketIntegrity: проверка подлинности COM уровня целостности пакетов.
- PacketPrivacy: проверка подлинности COM уровня конфиденциальности пакетов.
- без изменений: то же, что и предыдущая команда.
Дополнительные сведения о значениях этого параметра см. в разделе AuthenticationLevel.
Свойства параметров
| Тип: | AuthenticationLevel |
| Default value: | Packet |
| Допустимые значения: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Аутентификация |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Принудительное завершение работы компьютера.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Impersonation
Указывает уровень олицетворения, используемый при вызове WMI этого командлета. Значение по умолчанию — олицетворения.
Stop-Computer использует WMI. Допустимые значения для этого параметра:
- по умолчанию: олицетворение по умолчанию.
- анонимный: скрывает удостоверение вызывающего объекта.
- Определить: позволяет объектам запрашивать учетные данные вызывающего объекта.
- олицетворения: позволяет объектам использовать учетные данные вызывающего объекта.
Свойства параметров
| Тип: | ImpersonationLevel |
| Default value: | Impersonate |
| Допустимые значения: | Default, Anonymous, Identify, Impersonate, Delegate |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Protocol
Указывает, какой протокол используется для перезапуска компьютеров. Допустимые значения для этого параметра: WSMan и DCOM. Значение по умолчанию — DCOM.
Этот параметр появился в PowerShell 3.0.
Свойства параметров
| Тип: | String |
| Default value: | DCOM |
| Допустимые значения: | DCOM, WSMan |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ThrottleLimit
Указывает максимальное количество одновременных подключений, которые можно установить для выполнения этой команды. Если этот параметр не указан или введите значение 0, используется значение по умолчанию 32.
Ограничение регулирования применяется только к текущей команде, а не к сеансу или к компьютеру.
Свойства параметров
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не выполняется.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WsmanAuthentication
Указывает механизм, используемый для проверки подлинности учетных данных пользователя, когда этот командлет использует протокол WSMan. Значение по умолчанию — Default.
Допустимые значения для этого параметра:
- Базовый
- CredSSP
- По умолчанию
- дайджест
- Kerberos
- Вести переговоры.
Дополнительные сведения о значениях этого параметра см. в разделе AuthenticationMechanism.
Осторожность
Проверка подлинности поставщика служб безопасности учетных данных (CredSSP), в которой учетные данные пользователя передаются на удаленный компьютер для проверки подлинности, предназначена для команд, требующих проверки подлинности на нескольких ресурсах, таких как доступ к удаленному сетевому ресурсу. Этот механизм повышает риск безопасности удаленной операции. Если удаленный компьютер скомпрометирован, учетные данные, передаваемые ему, можно использовать для управления сетевым сеансом.
Этот параметр появился в PowerShell 3.0.
Свойства параметров
| Тип: | String |
| Default value: | Default |
| Допустимые значения: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
None
Невозможно передать объекты в этот командлет.
Выходные данные
None
По умолчанию этот командлет не возвращает выходные данные.
System.Management.Automation.RemotingJob
При использовании параметра AsJob этот командлет возвращает объект RemotingJob.
Примечания
Этот командлет использует метод Win32Shutdown класса WMI Win32_OperatingSystem. Этот метод требует включения привилегий SeShutdownPrivilege для учетной записи пользователя, используемой для завершения работы компьютера.
