Stop-Computer
Yerel ve uzak bilgisayarları durdurur (kapatır).
Syntax
All
Stop-Computer
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-AsJob]
[-DcomAuthentication <AuthenticationLevel>]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-Impersonation <ImpersonationLevel>]
[-ThrottleLimit <Int32>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Stop-Computer cmdlet'i yerel bilgisayarı ve uzak bilgisayarları kapatır.
Kapatma işlemlerini arka plan işi olarak çalıştırmak, kimlik doğrulama düzeylerini ve alternatif kimlik bilgilerini belirtmek, komutu çalıştırmak için oluşturulan eşzamanlı bağlantıları sınırlamak ve anında kapatmayı zorlamak için Stop-Computer parametrelerini kullanabilirsiniz.
Bu cmdlet, AsJob parametresini kullanmadığınız sürece PowerShell uzaktan iletişimini gerektirmez.
Ö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.
$j = Stop-Computer -ComputerName "Server01", "Server02" -AsJob
$results = $j | Receive-Job
$results
Stop-Computer, iki uzak bilgisayarı belirtmek için ComputerName parametresini kullanır.
AsJob parametresi, 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.
asjob
Örnek 4: Uzak bilgisayarı kapatma
Bu örnek, belirtilen kimlik doğrulamayı kullanarak uzak bilgisayarı kapatır.
Stop-Computer -ComputerName "Server01" -Impersonation Anonymous -DcomAuthentication PacketIntegrity
Stop-Computer uzak bilgisayarı belirtmek için ComputerName parametresini kullanır.
Kimliğe Bürünme parametresi özelleştirilmiş bir kimliğe bürünme belirtir ve DcomAuthentication parametresi kimlik doğrulama düzeyi ayarları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 -ThrottleLimit 10 -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.
ThrottleLimit parametresi komutu 10 eşzamanlı bağlantıyla sınırlar.
Kimlik Bilgisi parametresi, $c değişkenine kaydedilen kimlik bilgilerini gönderir.
Parametreler
-AsJob
Bu cmdlet'in arka plan işi olarak çalıştığını gösterir.
Bu parametreyi kullanmak için yerel ve uzak bilgisayarların uzaktan iletişim için yapılandırılması ve Windows Vista'da ve Windows işletim sisteminin sonraki sürümlerinde Yönetici olarak çalıştır
AsJob parametresini belirttiğinizde, komut hemen arka plan işini temsil eden bir nesne döndürür. İş tamamlarken oturumda çalışmaya devam edebilirsiniz. İş yerel bilgisayarda oluşturulur ve uzak bilgisayarlardan alınan sonuçlar otomatik olarak yerel bilgisayara döndürülür. İş sonuçlarını almak için Receive-Job cmdlet'ini kullanın.
PowerShell arka plan işleri hakkında daha fazla bilgi için bkz. about_Jobs ve about_Remote_Jobs.
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 |
-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.
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?.
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 |
-DcomAuthentication
Bu cmdlet'in WMI ile kullandığı kimlik doğrulama düzeyini belirtir.
Stop-Computer WMI kullanır. Varsayılan değer Paket değeridir.
Bu parametre için kabul edilebilir değerler şunlardır:
- Varsayılan: Windows Kimlik Doğrulaması.
- Hiçbiri: COM kimlik doğrulaması yok.
- Connect: Connect-level COM kimlik doğrulaması.
- Arama: Çağrı düzeyi COM kimlik doğrulaması.
- Paket: Paket düzeyi COM kimlik doğrulaması.
- PacketIntegrity: Paket Bütünlüğü düzeyi COM kimlik doğrulaması.
- PacketPrivacy: Paket Gizlilik düzeyi COM kimlik doğrulaması.
- Değişmemiş: Önceki komutla aynıdır.
Bu parametrenin değerleri hakkında daha fazla bilgi için bkz. authenticationLevel .
Parametre özellikleri
| Tür: | AuthenticationLevel |
| Default value: | Packet |
| Kabul edilen değerler: | Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Kimlik doğrulama |
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 |
-Force
Bilgisayarın hemen kapatılmasını zorlar.
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 |
-Impersonation
Bu cmdlet WMI'yi çağırırken kullanılacak kimliğe bürünme düzeyini belirtir. Varsayılan değer Kimliğe Büründeğeridir.
Stop-Computer WMI kullanır. Bu parametre için kabul edilebilir değerler şunlardır:
- Varsayılan: Varsayılan kimliğe bürünme.
- anonim
: Çağıranın kimliğini gizler. - Tanımla: Nesnelerin çağıranın kimlik bilgilerini sorgulamasına izin verir.
- Kimliğe Bürün: Nesnelerin çağıranın kimlik bilgilerini kullanmasına izin verir.
Parametre özellikleri
| Tür: | ImpersonationLevel |
| Default value: | Impersonate |
| Kabul edilen değerler: | Default, Anonymous, Identify, Impersonate, Delegate |
| 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 |
-Protocol
Bilgisayarları yeniden başlatmak için hangi protokolün kullanılacağını belirtir. Bu parametre için kabul edilebilir değerler şunlardır: WSMan ve DCOM. Varsayılan değer DCOMdeğeridir.
Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | String |
| Default value: | DCOM |
| Kabul edilen değerler: | DCOM, WSMan |
| 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 |
-ThrottleLimit
Bu komutu çalıştırmak için oluşturulabilecek en fazla eşzamanlı bağlantı sayısını belirtir. Bu parametreyi atlar veya 0 değerini girerseniz, varsayılan değer olan 32 kullanılır.
Hız sınırlaması yalnızca geçerli komut için geçerlidir, oturuma veya bilgisayara uygulanmaz.
Parametre özellikleri
| Tür: | Int32 |
| Default value: | None |
| 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.
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
Varsayılan olarak, bu cmdlet çıkış döndürmez.
System.Management.Automation.RemotingJob
AsJob parametresini kullandığınızda, bu cmdlet bir RemotingJob nesnesi döndürür.
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.
