Stop-Computer
Yerel ve uzak bilgisayarları durdurur (kapatır).
Sözdizimi
All
Stop-Computer
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-WsmanAuthentication <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Stop-Computer cmdlet'i yerel bilgisayarı ve uzak bilgisayarları kapatır.
Kimlik doğrulama düzeylerini ve alternatif kimlik bilgilerini belirtmek ve anında kapatmayı zorlamak için Stop-Computer parametrelerini kullanabilirsiniz.
PowerShell 7.1'de Linux ve macOS için Stop-Computer eklendi. Windows olmayan platformlarda yalnızca WhatIf, Confirm ve CommonParameters parametreleri bulunur. Cmdlet yalnızca /sbin/shutdownyerel komutunu ç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ışır.
arka plan işleci &Stop-Computer komutunu 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-Computer, iki uzak bilgisayarı belirtmek için ComputerName parametresini kullanır.
& arka plan işleci, komutu arka plan işi olarak çalıştırır. İş nesneleri $j değişkeninde depolanır.
$j değişkenindeki iş nesneleri, iş sonuçlarını alan Receive-Jobişlem hattına gönderilir. Nesneler $results değişkeninde depolanır.
$results değişkeni, PowerShell konsolunda iş bilgilerini 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 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ı listesini içeren bir dosya almak için Path parametresini kullanır. Nesneler $s değişkeninde depolanır.
Get-Credential, etki alanı yöneticisinin kimlik bilgilerini belirtmek için Kimlik Bilgisi parametresini kullanır. Kimlik bilgileri $c değişkeninde depolanır.
Stop-Computer, ComputerName parametresinin $s değişkenindeki bilgisayar listesiyle belirtilen bilgisayarları kapatır.
Force parametresi anında kapatmaya zorlar.
Kimlik Bilgisi parametresi, $c değişkenine kaydedilen kimlik bilgilerini gönderir.
Parametreler
-ComputerName
Durdurulacak bilgisayarları belirtir. Varsayılan değer 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.
Bu parametre yalnızca Windows platformlarında kullanılabilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Çin, __SUNUCU, Sunucu, IP Adresi |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Credential
Bu eylemi yapma izni olan bir kullanıcı hesabı belirtir. Varsayılan değer mevcut kullanıcıdır.
User01 veya Domain01\User01gibi bir kullanıcı adı yazın veya cmdlet'i tarafından oluşturulan Get-Credential nesnesi girin. Bir kullanıcı adı yazarsanız parolayı girmeniz istenir.
Kimlik bilgileri bir PSCredential nesnesinde depolanır ve parola SecureStringolarak depolanır.
Uyarı
SecureString veri koruması hakkında daha fazla bilgi için bkz. SecureString ne kadar güvenli?.
Bu parametre yalnızca Windows platformlarında kullanılabilir.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | Current user |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
Bilgisayarın hemen kapatılmasını zorlar.
Bu parametre yalnızca Windows platformlarında kullanılabilir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 Default'dir.
Bu parametre için kabul edilebilir değerler şunlardır:
- Temel
- CredSSP
- Varsayılan
- Özet
- Kerberos Gölü
- 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. Bu parametre yalnızca Windows platformlarında kullanılabilir.
Parametre özellikleri
| Tür: | String |
| Default value: | Default |
| Kabul edilen değerler: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
None
Bu cmdlet çıkış döndürmez.
Notlar
Bu cmdlet, Win32_OperatingSystem WMI sınıfının Win32Shutdown yöntemini kullanır. Bu yöntem, makineyi kapatmak için kullanılan kullanıcı hesabı için SeShutdownPrivilege ayrıcalığının etkinleştirilmesini gerektirir.
PowerShell 7.1'de Linux ve macOS için Stop-Computer eklendi. Bu platformlar için cmdlet, /sbin/shutdownyerel komutunu çağırır.
