Stop-Computer (Microsoft.PowerShell.Management)

Stop-Computer

Modül:: Microsoft.PowerShell.Management

Yerel ve uzak bilgisayarları durdurur (kapatır).

Sözdizimi

Stop-Computer
    [-WsmanAuthentication <String>]
    [[-ComputerName] <String[]>]
    [[-Credential] <PSCredential>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Tanım

Stop-Computer cmdlet'i yerel bilgisayarı ve uzak bilgisayarları kapatır.

Kimlik doğrulama düzeylerini ve alternatif kimlik bilgilerini belirtmek ve anında kapanmayı zorlamak için Bilgisayarı Durdur parametrelerini kullanabilirsiniz.

PowerShell 7.1'de Linux ve macOS için Bilgisayarı Durdur eklendi. Parametrelerin bu platformlar üzerinde hiçbir etkisi yoktur. Cmdlet yalnızca yerel /sbin/shutdown komutunu çağırıyor.

Örnekler

Örnek 1: Yerel bilgisayarı kapatın

Bu örnek yerel bilgisayarı kapatır.

Stop-Computer -ComputerName localhost

Örnek 2: İki uzak bilgisayarı ve yerel bilgisayarı kapatın

Bu örnek, iki uzak bilgisayarı ve yerel bilgisayarı durdurur.

Stop-Computer -ComputerName "Server01", "Server02", "localhost"

Stop-Computer, iki uzak bilgisayarı ve yerel bilgisayarı belirtmek için BilgisayarAdı parametresini kullanır. Her bilgisayar kapatılır.

Örnek 3: Uzak bilgisayarları arka plan işi olarak kapatma

Bu örnekte Bilgisayarı Durdur iki uzak bilgisayarda arka plan işi olarak çalışıyor.

Arka plan operatörü &, arka plan işi olarak Bilgisayarı Durdur komutunu çalıştırır. Daha fazla bilgi için bkz. about_Operators.

$j = Stop-Computer -ComputerName "Server01", "Server02" &
$results = $j | Receive-Job
$results

Bilgisayar Durdur, iki uzak bilgisayarı belirtmek için BilgisayarAdı parametresini kullanır. & arka plan operatörü, komutu bir arka plan işi olarak çalıştırır. İş nesneleri $j değişkeninde saklanır.

$j değişkenindeki iş nesneleri, iş sonuçlarını alan Receive-Job'a ardışık düzen üzerinden gönderilir. Nesneler $results değişkeninde saklanır. $results değişkeni, PowerShell konsolunda iş bilgilerini görüntüler.

Örnek 4: Uzaktaki bir bilgisayarı kapatma

Bu örnek, belirtilen kimlik doğrulamayı kullanarak uzaktaki bir bilgisayarı kapatır.

Stop-Computer -ComputerName "Server01" -WsmanAuthentication Kerberos

Bilgisayarı Durdur uzak bilgisayarı belirtmek için BilgisayarAdı parametresini kullanır. WsmanAuthentication parametresi uzak bağlantı kurmak için Kerberos'un kullanılacağını belirtir.

Örnek 5: Etki alanındaki bilgisayarları kapatın

Bu örnekte komutlar, belirli bir etki alanındaki tüm bilgisayarların anında kapatılmasına zorlar.

$s = Get-Content -Path ./Domain01.txt
$c = Get-Credential -Credential Domain01\Admin01
Stop-Computer -ComputerName $s -Force -Credential $c

Get-Content, geçerli dizinde etki alanı bilgisayarlarının listesini içeren bir dosya almak için Path parametresini kullanır. Nesneler $s değişkeninde saklanır.

Get-Credential, bir alan adı yöneticisinin kimlik bilgilerini belirtmek için Kimlik Bilgisi parametresini kullanır. Kimlik bilgileri $c değişkeninde saklanır.

Stop-Computer, BilgisayarAdı parametresinin $s değişkenindeki bilgisayar listesiyle belirtilen bilgisayarları kapatır. Zorla parametresi anında kapanmaya zorlar. Kimlik Bilgileri parametresi, $c değişkeninde kayıtlı kimlik bilgilerini gönderir.

Parametreler

-ComputerName

Durdurulacak bilgisayarları belirtir. Varsayılan yerel bilgisayardır.

Bir veya daha fazla bilgisayarın NETBIOS adını, IP adresini veya tam etki alanı adını virgülle ayrılmış bir listeye yazın. Yerel bilgisayarı belirtmek için bilgisayar adını veya localhost'u yazın.

Bu parametre PowerShell uzaktan iletişimine bağlı değildir. Bilgisayarınız uzak komutları çalıştıracak şekilde yapılandırılmamış olsa bile BilgisayarAdı parametresini kullanabilirsiniz.

Tip :: String[]
Takma adlar:: CN, __SERVER, Server, IPAddress
Konum:: 0
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: True
Joker karakterleri kabul et:: False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tip :: SwitchParameter
Takma adlar:: cf
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Credential

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabını belirtir. Varsayılan geçerli kullanıcıdır.

User01 veya Domain01\User01 gibi bir kullanıcı adı yazın veya Get-Credential tarafından oluşturulan bir PSCredential nesnesi girin kod > cmdlet'i seçin. Bir kullanıcı adı yazarsanız parolayı girmeniz istenir.

Kimlik bilgileri bir PSCredential nesnesinde, parola ise SecureString olarak depolanır.

Not

SecureString veri koruması hakkında daha fazla bilgi için bkz. SecureString ne kadar güvenli?.

Tip :: PSC kimlik bilgisi
Konum:: 1
Varsayılan değer:: Geçerli kullanıcı
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Force

Bilgisayarın anında kapanmasını zorlar.

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Tip :: SwitchParameter
Takma adlar:: wi
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-WsmanAuthentication

Bu cmdlet WSMan protokolünü kullandığında kullanıcı kimlik bilgilerinin kimliğini doğrulamak için kullanılan mekanizmayı belirtir. Varsayılan değer Varsayılan'dır.

Bu parametre için kabul edilebilir değerler şunlardır:

Temel
CredSSP
Varsayılan
Özet
Kerberos
Pazarlık yapın.

Bu parametrenin değerleri hakkında daha fazla bilgi için bkz. Kimlik Doğrulama Mekanizması.

Dikkat

Kullanıcı kimlik bilgilerinin kimlik doğrulaması için uzaktaki bir bilgisayara iletildiği Kimlik Bilgisi Güvenliği Hizmet Sağlayıcısı (CredSSP) kimlik doğrulaması, uzak bir ağ paylaşımına erişim gibi birden fazla kaynakta kimlik doğrulaması gerektiren komutlar için tasarlanmıştır. Bu mekanizma uzaktan işlemin güvenlik riskini artırır. Uzak bilgisayarın güvenliği ihlal edilirse, kendisine iletilen kimlik bilgileri ağ oturumunu denetlemek için kullanılabilir.

Bu parametre PowerShell 3,0'da tanıtıldı.

Tip :: String
Kabul edilen değerler:: Varsayılan, Temel, Anlaşma, CredSSP, Özet, Kerberos
Konum:: Adlandırılmış
Varsayılan değer:: Varsayılan
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

Girişler

Yok

Nesneleri bu cmdlet'e aktaramazsınız.

Çıkışlar