uruchamia ponownie system operacyjny na komputerach lokalnych i zdalnych.
- składnia
- opis
- przykłady
- przykład 1: Restart komputera lokalnego
- przykład 2: Ponowne uruchomienie wielu komputerów
- przykład 3: Pobierz nazwy komputerów z pliku tekstowego
- przykład 4: wymusza ponowne uruchomienie komputerów wymienionych w pliku tekstowym
- przykład 6: Uruchom ponownie zdalny komputer i poczekaj, aż PowerShell
- przykład 7: Uruchom ponownie komputer za pomocą WsmanAuthentication
- parametry
- Inputs
- Outputs
- uwagi
składnia
opis
polecenie poleceniaRestart-Computer uruchamia ponownie system operacyjny na komputerach lokalnych i zdalnych.
możesz użyć parametrówRestart-Computer, aby uruchomić operacje restartu, określić poziomy autoryzacji i alternatywne poświadczenia,ograniczyć operacje uruchamiane w tym samym czasie i wymusić natychmiastowe ponowne uruchomienie.
począwszy od Windows PowerShell 3.0, możesz poczekać na zakończenie restartu przed uruchomieniem nextcommand. Określ czas oczekiwania i interwał zapytań, a następnie poczekaj na udostępnienie poszczególnych usług na zrestartowanym komputerze. Ta funkcja sprawia, że praktyczne jest używanieRestart-Computer skryptów i funkcji.
przykłady
przykład 1: Restart komputera lokalnego
Restart-Computer restartuje komputer lokalny.
Restart-Computerprzykład 2: Ponowne uruchomienie wielu komputerów
Restart-Computer może ponownie uruchomić komputery zdalne i lokalne. Parametr ComputerName akceptuje wielokrotność nazw komputerów.
Restart-Computer -ComputerName Server01, Server02, localhostprzykład 3: Pobierz nazwy komputerów z pliku tekstowego
Restart-Computer pobiera listę nazw komputerów z pliku tekstowego i uruchamia ponownie Komputery. Parametr computername nie jest podany. Ale ponieważ jest to pierwszy parametr pozycji, przyjmuje nazwy komputerów z pliku tekstowego, które są wysyłane w potoku.
Get-Content -Path C:\Domain01.txt | Restart-ComputerGet-Content używa parametru Path,aby uzyskać listę nazw komputerów z pliku tekstowego Domain01.txt. Nazwy komputerów są wysyłane w dół rurociągu. Restart-Computer restartuje każdy komputer.
przykład 4: wymusza ponowne uruchomienie komputerów wymienionych w pliku tekstowym
Ten przykład wymusza natychmiastowe ponowne uruchomienie komputerów wymienionych w pliku Domain01.txt. Nazwy komputerów z pliku tekstowego są przechowywane w zmiennej. Parametr Force wymusza ponowne uruchomienie programu animmediate.
Get-Content używa parametru Path,aby uzyskać listę nazw komputerów z pliku tekstowego Domain01.txt. Nazwy komputerów są zapisywane w zmiennej $NamesGet-Credential pyta o nazwę użytkownika i hasło i przechowuje wartości w zmiennej$CredsRestart-Computerużywa nazw obliczeniowych i parametrów poświadczenia wraz z ich zmiennymi. Forceparametr powoduje natychmiastowe ponowne uruchomienie każdego komputera.
przykład 6: Uruchom ponownie zdalny komputer i poczekaj, aż PowerShell
Restart-Computer uruchamia ponownie zdalny komputer, a następnie czeka do 5 minut (300 sekund), aż PowerShell stanie się dostępny na zrestartowanym komputerze, zanim będzie kontynuowany.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2Restart-Computer używa parametru ComputerName do określenia Server01. Waitparameter czeka na zakończenie restartu. For określa, że PowerShell może uruchamiać polecenia na zdalnym komputerze. Parametr Timeout określa pięciominutowe oczekiwanie. Parametr opóźnienia pyta zdalny komputer co dwie sekundy, aby określić, czy został ponownie uruchomiony.
przykład 7: Uruchom ponownie komputer za pomocą WsmanAuthentication
Restart-Computer uruchom ponownie zdalny komputer za pomocą mechanizmu WsmanAuthentication.Uwierzytelnianie Kerberos określa, czy bieżący użytkownik ma uprawnienia do ponownego uruchomienia komputera remotecomputer. Aby uzyskać więcej informacji, patrzauthenticationmechanizm.
Restart-Computer -ComputerName Server01 -WsmanAuthentication KerberosRestart-Computer używa parametru ComputerName do określenia zdalnego komputera, Server01.Parametr WsmanAuthentication określa metodę uwierzytelniania jako Kerberos.
parametry
określa nazwę jednego komputera lub oddzieloną przecinkami tablicę nazw komputerów. Restart-Computer akceptuje obiekty nazwakomputera z potoku lub zmiennych.
wpisz nazwę NetBIOS, adres IP lub w pełni kwalifikowaną nazwę domeny komputera zdalnego. Określ komputer lokalny, wpisz nazwę komputera, kropkę. lub localhost.
ten parametr nie polega na remotowaniu PowerShella. Możesz użyć parametru ComputerName nawet jeśli twój komputer nie jest skonfigurowany do uruchamiania zdalnych poleceń.
Jeśli parametr ComputerName nie jest określony,Restart-Computer uruchamia ponownie komputer lokalny.
| Typ: | ciąg |
| aliasy: | CN, __serwer, serwer, IPAddress |
| pozycja: | 0 |
| wartość domyślna: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Prompts you for confirmation before running Restart-Computer.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
określa konto Użytkownika, które ma uprawnienia do wykonania tej akcji. Domyślną wartością jest bieżący użytkownik.
wpisz nazwę użytkownika, taką jak User01 lub Domain01\User01, lub wprowadź obiekt PSCredential generowany przez polecenieGet-Credential. Jeśli wpiszesz nazwę użytkownika, zostanie wyświetlony monit o wpisanie hasła.
poświadczenia są przechowywane w PSCredentialobject, a hasło jest przechowywane jako SecureString.
Note
For more information about SecureString data protection, seeHow secure is SecureString?.
| Type: | PSCredential |
| Position: | 1 |
| Default value: | Current user |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the frequency of queries, in seconds. PowerShell zapytuje usługę określoną przez parametr theFor, aby określić, czy usługa jest dostępna po ponownym uruchomieniu komputera.
ten parametr jest ważny tylko razem z parametrami Wait I For.
ten parametr został wprowadzony w Windows PowerShell 3.0.
Jeśli parametr opóźnienia nie jest określony, Restart-Computer używa pięciosekundowego opóźnienia.
| Typ: | Int16 |
| pozycja: | Nazwa |
| Wartość domyślna: | brak |
| Akceptuj wejście rurociągu: | False |
| Akceptuj znaki wieloznaczne: | False |
określa zachowanie PowerShell, gdy oczekuje na dostęp do określonej usługi lub funkcji po ponownym uruchomieniu komputera. Ten parametr jest ważny tylko z parametrem Wait.
dopuszczalne wartości dla tego parametru to:
- domyślnie: czeka na ponowne uruchomienie PowerShell.
- PowerShell: może uruchamiać polecenia w zdalnej sesji PowerShell na komputerze.
- WMI: Otrzymuje odpowiedź na zapytanie Win32_ComputerSystem dla komputera.
- WinRM: może ustanowić zdalną sesję na komputerze za pomocą WS-Management.
ten parametr został wprowadzony w Windows PowerShell 3.0.
| Typ: | WaitForServiceTypes |
| akceptowane wartości: | WMI, WinRM, PowerShell |
| pozycja: | Nazwa |
| wartość domyślna: | brak |
| Akceptuj wejście potoku: | false |
| Akceptuj znaki wieloznaczne: | False |
Forces an immediate restart of the computer.
| Type: | SwitchParameter |
| Aliases: | f |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the duration of the wait, in seconds. Gdy upłynie limit czasu, Restart-Computer powróci do wiersza polecenia, nawet jeśli komputery nie zostaną ponownie uruchomione.
parametr Timeout jest ważny tylko z parametrem Wait. Timeout zastępuje nieokreślony czas oczekiwania parametru wait.
ten parametr został wprowadzony w Windows PowerShell 3.0.
| Typ: | Int32 |
| aliasy: | TimeoutSec |
| pozycja: | Nazwa |
| Wartość domyślna: | brak |
| Akceptuj wejście rurociągu: | False |
| Akceptuj znaki wieloznaczne: | False |
Restart-Computer tłumi znak zachęty PowerShell i blokuje rurociąg do momentu uruchomienia komputerów. Możesz użyć tego parametru w skrypcie do restartu komputerów, a następnie kontynuować proces po zakończeniu restartu.
parametr Wait czeka w nieskończoność Na ponowne uruchomienie komputerów. Możesz użyć Timeout, aby dostosować czas oraz parametry For I Delay, aby poczekać, aż poszczególne usługi staną się dostępne na ponownie uruchomionych komputerach.
parametr Wait nie jest poprawny podczas ponownego uruchamiania komputera lokalnego. Jeśli wartość parametru computername zawiera nazwy komputerów zdalnych i komputera lokalnego,Restart-Computer generuje błąd nie kończący oczekiwania na komputerze lokalnym, ale czekający na ponowne uruchomienie komputerów zdalnych.
ten parametr został wprowadzony w Windows PowerShell 3.0.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Shows what would happen if the Restart-Computer runs. The Restart-Computer cmdlet isn’t run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Nazwa |
| Wartość domyślna: | False |
| Akceptuj wejście potoku: | False | Akceptuj znaki wieloznaczne: | False |
określa mechanizm, który jest używany do uwierzytelniania poświadczeń użytkownika. Ten parametr został wprowadzony w Windows PowerShell 3.0.
dopuszczalne wartości dla tego parametru to: Basic, CredSSP,Default, Digest, Kerberos i Negotiate.
aby uzyskać więcej informacji, patrzauthenticationmechanizm.
Warning
uwierzytelnianie dostawcy usług zabezpieczeń poświadczeń (CredSSP), w którym poświadczenia użytkownika są przekazywane do zdalnego komputera w celu uwierzytelnienia, jest przeznaczone dla poleceń wymagających uwierzytelnienia na więcej niż jednym zasobie, takich jak dostęp do zdalnego udziału sieciowego. Mechanizm ten zwiększa ryzyko bezpieczeństwa związane ze zdalną obsługą. Jeśli zdalny komputer jest zagrożony, thecredentials, które są do niego przekazywane, mogą być używane do sterowania sesją sieciową.
| Typ: | String |
| akceptowane wartości: | Basic, CredSSP, Default, Digest, Kerberos, Negotiate |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
String
Restart-Computer accepts computer names from the pipeline or variables.
Outputs
None
Restart-Computer doesn’t generate any output.
uwagi
- w systemie Windows
Restart-Computerużywa metody Win32Shutdown z klasy Windows Management Instrumentation (WMI) Win32_OperatingSystemclass. Ta metoda wymaga włączenia uprawnień SeShutdownPrivilege dla konta użytkownika używanego do ponownego uruchomienia maszyny. - w systemach Linux i Mac OS
Restart-Computerużywa narzędzia bash/sbin/shutdown.
- o zdalnym zarządzaniu systemem Windows
- Get-Credential
- WS-Management Protocol