Enable-PSRemoting

Modül:
Microsoft.PowerShell.Core Module

Bilgisayarı uzak komutları alacak şekilde yapılandırılır.

Syntax

Default (Varsayılan) 

Enable-PSRemoting
    [-Force]
    [-SkipNetworkProfileCheck]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Enable-PSRemoting cmdlet'i, bilgisayarı WS-Management teknolojisi kullanılarak gönderilen PowerShell uzak komutlarını alacak şekilde yapılandırılır.

PowerShell uzaktan iletişim, Windows Server 2012 ve üzeri sürümlerde varsayılan olarak etkindir. windows'un desteklenen diğer sürümlerinde PowerShell uzaktan iletişimini etkinleştirmek ve devre dışı bırakılırsa uzaktan iletişimi yeniden etkinleştirmek için Enable-PSRemoting kullanabilirsiniz.

Komut alan her bilgisayarda bu komutu yalnızca bir kez çalıştırmanız gerekir. Yalnızca komut gönderen bilgisayarlarda çalıştırmanıza gerek yoktur. Yapılandırma dinleyicileri başlattığından, yalnızca gerektiğinde çalıştırmak akıllıca olur.

PowerShell 3.0'dan başlayarak, Enable-PSRemoting cmdlet'i bilgisayar genel bir ağdayken Windows'un istemci sürümlerinde PowerShell uzaktan iletişimini etkinleştirebilir. Daha fazla bilgi için SkipNetworkProfileCheck parametresinin açıklamasına bakın.

Enable-PSRemoting cmdlet'i aşağıdaki işlemleri gerçekleştirir:

  • Aşağıdaki görevleri gerçekleştiren Set-WSManQuickConfig cmdlet'ini çalıştırır:
    • WinRM hizmetini başlatır.
    • WinRM hizmetindeki başlangıç türünü Otomatik olarak ayarlar.
    • Herhangi bir IP adresinde istekleri kabul etmek için bir dinleyici oluşturur.
    • WS-Management iletişimler için güvenlik duvarı özel durumunu etkinleştirir.
    • Microsoft.PowerShell kaydeder ve microsoft.powershell.workflow oturum yapılandırmalarını (henüz kayıtlı değilse).
    • Microsoft.PowerShell32 oturum yapılandırmasını 64 bit bilgisayarlarda henüz kayıtlı değilse kaydeder.
    • Tüm oturum yapılandırmalarını etkinleştirir.
    • Uzaktan erişime izin vermek için tüm oturum yapılandırmalarının güvenlik tanımlayıcısını değiştirir.
  • Önceki değişiklikleri etkili hale getirmek için WinRM hizmetini yeniden başlatır.

Bu cmdlet'i Windows platformunda çalıştırmak için Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i başlatın.

PowerShell uzaktan iletişimini kullanma hakkında daha fazla bilgi için aşağıdaki makalelere bakın:

Örnekler

Örnek 1: Bir bilgisayarı uzak komutları alacak şekilde yapılandırma

Bu komut, bilgisayarı uzak komutları alacak şekilde yapılandırıyor.

Enable-PSRemoting

Örnek 2: Bir bilgisayarı, bir onay istemi olmadan uzak komutları alacak şekilde yapılandırma

Bu komut, bilgisayarı uzak komutları alacak şekilde yapılandırıyor. Zorla parametresi kullanıcı istemlerini gizler.

Enable-PSRemoting -Force

Örnek 3: İstemcilerde uzaktan erişime izin verme

Bu örnekte, Windows işletim sisteminin istemci sürümlerinde ortak ağlardan uzaktan erişime nasıl izin ver iletişiminin olduğu gösterilmektedir. Farklı Windows sürümleri için güvenlik duvarı kuralının adı farklı olabilir. Kuralların listesini görmek için Get-NetFirewallRule kullanın. Güvenlik duvarı kuralını etkinleştirmeden önce, yapılandırmanın ortamınıza uygun olduğunu doğrulamak için kuraldaki güvenlik ayarlarını görüntüleyin.

Get-NetFirewallRule -Name 'WINRM*' | Select-Object -Property Name

Name
----
WINRM-HTTP-In-TCP-NoScope
WINRM-HTTP-In-TCP
WINRM-HTTP-Compat-In-TCP-NoScope
WINRM-HTTP-Compat-In-TCP

Enable-PSRemoting -SkipNetworkProfileCheck -Force
Set-NetFirewallRule -Name 'WINRM-HTTP-In-TCP' -RemoteAddress Any

Varsayılan olarak, Enable-PSRemoting özel ağlardan ve etki alanı ağlarından uzaktan erişime izin veren ağ kuralları oluşturur. Komut, aynı yerel alt ağının ortak ağlarından uzaktan erişime izin vermek için SkipNetworkProfileCheck parametresini kullanır. komut, onay iletilerini engellemek için Zorla parametresini belirtir.

SkipNetworkProfileCheck parametresi, varsayılan olarak aynı yerel alt ağının ortak ağlarından uzaktan erişime izin veren Windows işletim sisteminin sunucu sürümlerini etkilemez.

Set-NetFirewallRule modülündeki cmdlet'i, herhangi bir uzak konumdan ortak ağlardan uzaktan erişime izin veren bir güvenlik duvarı kuralı ekler. Bu, farklı alt ağlardaki konumları içerir.

Uyarı

Windows sürümüne bağlı olarak güvenlik duvarı kuralının adı farklı olabilir. Sisteminizdeki kuralların adlarını listelemek için Get-NetFirewallRule cmdlet'ini kullanın.

Parametreler

-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

-Force

Komutu, kullanıcı onayı istemeden çalışmaya zorlar.

Parametre özellikleri

Tür:SwitchParameter
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

-SkipNetworkProfileCheck

Bu cmdlet'in, bilgisayar bir genel ağdayken Windows işletim sisteminin istemci sürümlerinde uzaktan iletişimin etkinleştirildiğini gösterir. Bu parametre, ortak ağlar için yalnızca aynı yerel alt ağının bilgisayarlarından uzaktan erişime izin veren bir güvenlik duvarı kuralı sağlar.

Bu parametre, varsayılan olarak genel ağlar için yerel bir alt ağ güvenlik duvarı kuralına sahip olan Windows işletim sisteminin sunucu sürümlerini etkilemez. Yerel alt ağ güvenlik duvarı kuralı bir sunucu sürümünde devre dışı bırakılırsa, Enable-PSRemoting bu parametrenin değerinden bağımsız olarak yeniden etkinleştirir.

Yerel alt ağ kısıtlamasını kaldırmak ve ortak ağlardaki tüm konumlardan uzaktan erişimi etkinleştirmek için Set-NetFirewallRule modülündeki cmdlet'ini kullanın.

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

Parametre özellikleri

Tür:SwitchParameter
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

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

String

Bu cmdlet, sonuçlarını açıklayan dizeleri döndürür.

Notlar

PowerShell 3.0'dan başlayarak Enable-PSRemoting, tüm oturum yapılandırmalarının Etkin özelliğinin değerini $trueolarak ayarlayarak tüm oturum yapılandırmalarını etkinleştirir.

  • Windows işletim sisteminin sunucu sürümlerinde Enable-PSRemoting, uzaktan erişime izin veren özel ve etki alanı ağları için güvenlik duvarı kuralları oluşturur ve ortak ağlar için yalnızca aynı yerel alt ağının bilgisayarlarından uzaktan erişime izin veren bir güvenlik duvarı kuralı oluşturur.

  • Windows işletim sisteminin istemci sürümlerinde, PowerShell 3.0'daki Enable-PSRemoting, kısıtlanmamış uzaktan erişime izin veren özel ve etki alanı ağları için güvenlik duvarı kuralları oluşturur. Aynı yerel alt ağdan uzaktan erişime izin veren genel ağlara yönelik bir güvenlik duvarı kuralı oluşturmak için SkipNetworkProfileCheck parametresini kullanın.

  • Windows işletim sisteminin istemci veya sunucu sürümlerinde, yerel alt ağ kısıtlamasını kaldıran ve uzaktan erişime izin veren ortak ağlar için bir güvenlik duvarı kuralı oluşturmak üzere, Aşağıdaki komutu çalıştırmak için NetSecurity modülündeki Set-NetFirewallRule cmdlet'ini kullanın: Set-NetFirewallRule -Name "WINRM-HTTP-In-TCP-PUBLIC" -RemoteAddress Any

Enable-PSRemoting, tüm oturum yapılandırmalarının Enabled özelliğinin değerini $trueolarak ayarlayarak tüm oturum yapılandırmalarını etkinleştirir.

Enable-PSRemoting Deny_All ve Network_Deny_All ayarlarını kaldırır. Bu, yerel kullanım için ayrılmış oturum yapılandırmalarına uzaktan erişim sağlar.