Stop-Computer
Zatrzymuje (zamyka) komputery lokalne i zdalne.
Składnia
Stop-Computer
[-WsmanAuthentication <String>]
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie Stop-Computer
cmdlet zamyka komputer lokalny i komputery zdalne.
Możesz użyć parametrów , Stop-Computer
aby określić poziomy uwierzytelniania i alternatywne poświadczenia oraz wymusić natychmiastowe zamknięcie.
W programie PowerShell 7.1 Stop-Computer
dodano system Linux i macOS. Parametry nie mają wpływu na te platformy. Polecenie cmdlet po prostu wywołuje natywne polecenie /sbin/shutdown
.
Przykłady
Przykład 1: zamykanie komputera lokalnego
W tym przykładzie komputer lokalny jest zamykany.
Stop-Computer -ComputerName localhost
Przykład 2: Zamykanie dwóch komputerów zdalnych i komputera lokalnego
Ten przykład zatrzymuje dwa komputery zdalne i komputer lokalny.
Stop-Computer -ComputerName "Server01", "Server02", "localhost"
Stop-Computer
używa parametru ComputerName do określenia dwóch komputerów zdalnych i komputera lokalnego. Każdy komputer jest zamykany.
Przykład 3. Zamykanie komputerów zdalnych jako zadania w tle
W tym przykładzie Stop-Computer
działa jako zadanie w tle na dwóch komputerach zdalnych.
Operator &
w tle uruchamia Stop-Computer
polecenie jako zadanie w tle. Aby uzyskać więcej informacji, zobacz about_Operators.
$j = Stop-Computer -ComputerName "Server01", "Server02" &
$results = $j | Receive-Job
$results
Stop-Computer
używa parametru ComputerName do określenia dwóch komputerów zdalnych. Operator &
w tle uruchamia polecenie jako zadanie w tle. Obiekty zadania są przechowywane w zmiennej $j
.
Obiekty zadania w zmiennej $j
są wysyłane w dół potoku do Receive-Job
elementu , który pobiera wyniki zadania. Obiekty są przechowywane w zmiennej $results
. Zmienna $results
wyświetla informacje o zadaniu w konsoli programu PowerShell.
Przykład 4. Zamykanie komputera zdalnego
W tym przykładzie komputer zdalny jest zamykany przy użyciu określonego uwierzytelniania.
Stop-Computer -ComputerName "Server01" -WsmanAuthentication Kerberos
Stop-Computer
używa parametru ComputerName , aby określić komputer zdalny. Parametr WsmanAuthentication określa użycie protokołu Kerberos do nawiązania połączenia zdalnego.
Przykład 5. Zamykanie komputerów w domenie
W tym przykładzie polecenia wymuszają natychmiastowe zamknięcie wszystkich komputerów w określonej domenie.
$s = Get-Content -Path ./Domain01.txt
$c = Get-Credential -Credential Domain01\Admin01
Stop-Computer -ComputerName $s -Force -Credential $c
Get-Content
używa parametru Ścieżka , aby pobrać plik w bieżącym katalogu z listą komputerów domeny. Obiekty są przechowywane w zmiennej $s
.
Get-Credential
używa parametru Credential w celu określenia poświadczeń administratora domeny. Poświadczenia są przechowywane w zmiennej $c
.
Stop-Computer
wyłącza komputery określone przy użyciu parametru ComputerName listy komputerów w zmiennej $s
. Parametr Force wymusza natychmiastowe zamknięcie. Parametr Credential przesyła poświadczenia zapisane w zmiennej $c
.
Parametry
-ComputerName
Określa komputery do zatrzymania. Wartość domyślna to komputer lokalny.
Wpisz nazwę NETBIOS, adres IP lub w pełni kwalifikowaną nazwę domeny co najmniej jednego komputera na liście rozdzielanej przecinkami. Aby określić komputer lokalny, wpisz nazwę komputera lub hosta lokalnego.
Ten parametr nie polega na komunikacji zdalnej programu PowerShell. Można użyć parametru ComputerName , nawet jeśli komputer nie jest skonfigurowany do uruchamiania poleceń zdalnych.
Type: | String[] |
Aliases: | CN, __SERVER, Server, IPAddress |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Określa konto użytkownika, które ma uprawnienia do wykonania tej akcji. Wartość domyślna to użytkownik bieżący.
Wpisz nazwę użytkownika, taką jak User01 lub Domain01\User01, lub wprowadź obiekt PSCredential wygenerowany przez Get-Credential
polecenie cmdlet. Jeśli wpiszesz nazwę użytkownika, zostanie wyświetlony monit o wprowadzenie hasła.
Poświadczenia są przechowywane w obiekcie PSCredential , a hasło jest przechowywane jako secureString.
Uwaga
Aby uzyskać więcej informacji na temat ochrony danych SecureString , zobacz Jak bezpieczny jest protokół SecureString?.
Type: | PSCredential |
Position: | 1 |
Default value: | Current user |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Wymusza natychmiastowe zamknięcie komputera.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WsmanAuthentication
Określa mechanizm używany do uwierzytelniania poświadczeń użytkownika, gdy to polecenie cmdlet używa protokołu WSMan. Wartość domyślna to Wartość domyślna.
Dopuszczalne wartości tego parametru to:
- Podstawowy
- Protokół CredSSP
- Wartość domyślna
- Szyfrowane
- Kerberos
- Negocjować.
Aby uzyskać więcej informacji na temat wartości tego parametru, zobacz AuthenticationMechanism.
Uwaga
Uwierzytelnianie dostawcy usług zabezpieczeń poświadczeń (CredSSP), w którym poświadczenia użytkownika są przekazywane do komputera zdalnego do uwierzytelnienia, jest przeznaczone dla poleceń wymagających uwierzytelniania w więcej niż jednym zasobie, takich jak uzyskiwanie dostępu do zdalnego udziału sieciowego. Ten mechanizm zwiększa ryzyko bezpieczeństwa operacji zdalnej. W przypadku naruszenia zabezpieczeń komputera zdalnego poświadczenia przekazywane do niego mogą służyć do kontrolowania sesji sieciowej.
Ten parametr został wprowadzony w programie PowerShell 3.0.
Type: | String |
Accepted values: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
Position: | Named |
Default value: | Default |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
None
Nie można potokować obiektów do tego polecenia cmdlet.
Dane wyjściowe
None
To polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Uwagi
To polecenie cmdlet używa polecenia cmdlet Win32Shutdown
Win32_OperatingSystem
metoda klasy WMI. Ta metoda wymaga włączenia SeShutdownPrivilege
uprawnień dla konta użytkownika używanego do zamykania maszyny.
W programie PowerShell 7.1 Stop-Computer
dodano system Linux i macOS. W przypadku tych platform polecenie cmdlet wywołuje natywne polecenie /sbin/shutdown
.
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla