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 kapatmayı 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-Computeriki 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ışır.

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

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

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

Değişkendeki $j iş nesneleri, iş sonuçlarını alan işlem hattına Receive-Jobgönderilir. 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-Computeruzak 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 etki alanındaki tüm bilgisayarların hemen kapatılmasını zorunlu tutar.

$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 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-Computer, ComputerName parametresinin değişkendeki $s bilgisayar listesiyle belirtilen bilgisayarları kapatır. Force parametresi anında kapatmaya zorlar. Credential parametresi değişkene kaydedilen $c kimlik bilgilerini gönderir.

Parametreler

-ComputerName

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

Virgülle ayrılmış bir listeye 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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Bu eylemi yapma izni olan 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:False
Required: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
Required: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, bu bilgisayara 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
Required:False
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, 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 platformlar için cmdlet'i yerel komutunu /sbin/shutdownçağırır.