Stop-Computer

  • Başvuru
Modül:
Microsoft.PowerShell.Management

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

Syntax

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

Description

Stop-Computer Cmdlet, yerel bilgisayarı ve uzak bilgisayarları kapatır.

kimlik doğrulama düzeylerini Stop-Computer ve alternatif kimlik bilgilerini belirtmek ve anında kapanmaya zorlamak için parametresini kullanabilirsiniz.

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

Örnekler

Örnek 1: Yerel bilgisayarı kapatma

Bu örnek yerel bilgisayarı kapatır.

Stop-Computer -ComputerName localhost

Örnek 2: İki uzak bilgisayarı ve yerel bilgisayarı kapatma

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 ComputerName parametresini kullanır. Her bilgisayar kapatılır.

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

Bu örnekte, Stop-Computer iki uzak bilgisayarda arka plan işi olarak çalıştırılır.

Background işleci & komutu arka plan işi olarak çalıştırır Stop-Computer . Daha fazla bilgi için bkz. about_Operators.

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

Stop-Computer iki uzak bilgisayar belirtmek için ComputerName parametresini kullanır. Background & işleci komutu arka plan işi olarak çalıştırır. İş nesneleri değişkeninde $j depolanır.

değişkenindeki $j iş nesneleri işlem hattına Receive-Jobgönderilir ve bu da iş sonuçlarını alır. Nesneler değişkeninde $results depolanır. değişkeni, $results Iş bilgilerini PowerShell konsolunda görüntüler.

Örnek 4: Uzak bilgisayarı kapatma

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

Stop-Computer -ComputerName "Server01" -WsmanAuthentication Kerberos

Stop-Computer uzak bilgisayarı belirtmek için ComputerName parametresini kullanır. WsmanAuthentication parametresi, uzak bağlantı kurmak için Kerberos'un kullanılacağını belirtir.

Örnek 5: Etki alanındaki bilgisayarları kapatma

Bu örnekte, komutlar belirtilen bir etki alanındaki tüm bilgisayarların hemen kapatılmasını 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ı listesini içeren bir dosya almak için Path parametresini kullanır. Nesneler değişkeninde $s depolanır.

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

Stop-ComputerComputerName parametresinin değişkendeki $s bilgisayar listesiyle belirtilen bilgisayarları kapatır. Force parametresi anında kapatmaya zorlar. Credential parametresi değişkene $c kaydedilen kimlik bilgilerini gönderir.

Parametreler

-ComputerName

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

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

Bu parametre PowerShell uzaktan iletişimini desteklemez. Bilgisayarınız uzak komutları çalıştıracak şekilde yapılandırılmamış olsa bile ComputerName parametresini kullanabilirsiniz.

Type:String[]
Aliases:CN, __SERVER, Server, IPAddress
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Bu eylemi yapma iznine sahip bir kullanıcı hesabı belirtir. Varsayılan, mevcut kullanıcıdır.

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

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

Not

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

Type:PSCredential
Position:1
Default value:Current user
Accept pipeline input:False
Accept wildcard characters:False

-Force

Bilgisayarın hemen kapatılmasını zorlar.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-WsmanAuthentication

Bu cmdlet WSMan protokolunu 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 parametrenin kabul edilebilir değerleri şunlardır:

  • Temel
  • CredSSP
  • Varsayılan
  • Özet
  • Kerberos
  • Anlaşma.

Bu parametrenin değerleri hakkında daha fazla bilgi için bkz . AuthenticationMechanism.

Dikkat

Kimlik Bilgileri Güvenlik Hizmeti Sağlayıcısı (CredSSP) kimlik doğrulaması, kullanıcı kimlik bilgilerinin kimlik doğrulaması için uzak bir bilgisayara geçirildiği, uzak ağ paylaşımına erişme gibi birden fazla kaynakta kimlik doğrulaması gerektiren komutlar için tasarlanmıştır. Bu mekanizma, uzak işlemin güvenlik riskini artırır. Uzak bilgisayarın güvenliği aşılırsa, ona geçirilen kimlik bilgileri ağ oturumunu denetlemek için kullanılabilir.

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

Type:String
Accepted values:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:Default
Accept pipeline input:False
Accept wildcard characters:False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

Bu cmdlet şunu kullanır:Win32ShutdownWin32_OperatingSystem wmi sınıfının yöntemi. Bu yöntem, makineyi kapatmak için kullanılan kullanıcı hesabı için ayrıcalığının etkinleştirilmesini gerektirir SeShutdownPrivilege .

PowerShell 7.1'de Linux Stop-Computer ve macOS için eklendi. Bu takımlar için cmdlet'i yerel komutunu /sbin/shutdownçağırır.