New-WSManInstance
Yönetim kaynağının yeni bir örneğini oluşturur.
Syntax
ComputerName (Varsayılan)
New-WSManInstance
[-ResourceURI] <Uri>
[-SelectorSet] <Hashtable>
[-ApplicationName <String>]
[-ComputerName <String>]
[-FilePath <String>]
[-OptionSet <Hashtable>]
[-Port <Int32>]
[-SessionOption <SessionOption>]
[-UseSSL]
[-ValueSet <Hashtable>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
URI
New-WSManInstance
[-ResourceURI] <Uri>
[-SelectorSet] <Hashtable>
[-ConnectionURI <Uri>]
[-FilePath <String>]
[-OptionSet <Hashtable>]
[-SessionOption <SessionOption>]
[-ValueSet <Hashtable>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Description
Bu cmdlet yalnızca Windows platformunda kullanılabilir.
New-WSManInstance cmdlet'i bir yönetim kaynağının yeni bir örneğini oluşturur. Yönetim kaynağının yeni örneğini oluşturmak için bir kaynak URI'sini ve değer kümesini veya giriş dosyasını kullanır.
Bu cmdlet, yönetim kaynağı örneğini oluşturmak için WinRM bağlantı/aktarım katmanını kullanır.
Örnekler
Örnek 1: HTTPS dinleyicisi oluşturma
Bu komut, tüm IP adreslerinde WS-Management HTTPS dinleyicisinin bir örneğini oluşturur.
New-WSManInstance winrm/config/Listener -SelectorSet @{Transport='HTTPS'; Address='*'} -ValueSet @{Hostname="HOST";CertificateThumbprint="XXXXXXXXXX"}
Parametreler
-ApplicationName
Bağlantıdaki uygulama adını belirtir. ApplicationName parametresinin varsayılan değeri WSMAN değeridir. Uzak uç noktanın tam tanımlayıcısı aşağıdaki biçimdedir:
<transport>://<server>:<port>/<ApplicationName>
Örneğin:
http://server01:8080/WSMAN
Oturumu barındıran Internet Information Services (IIS), bu uç nokta ile istekleri belirtilen uygulamaya iletir. WSMAN bu varsayılan ayarı çoğu kullanım için uygundur. Bu parametre, çok sayıda bilgisayar Windows PowerShell çalıştıran bir bilgisayara uzak bağlantılar kurduğunda kullanılacak şekilde tasarlanmıştır. Bu durumda IIS, verimlilik için Yönetim için Web Hizmetlerini (WS-Management) barındırmaktadır.
Parametre özellikleri
| Tür: | String |
| Default value: | Wsman |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerName
| 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 |
-Authentication
Sunucuda kullanılacak kimlik doğrulama mekanizmasını belirtir. Olası değerler şunlardır:
- Temel: Temel, kullanıcı adı ve parolanın sunucuya veya ara sunucuya düz metin olarak gönderildiği bir düzendir.
- Varsayılan: WS-Management protokolü tarafından uygulanan kimlik doğrulama yöntemini kullanın. Varsayılan değer budur.
- Özet: Özet, sınama için sunucuda belirtilen bir veri dizesi kullanan bir sınama yanıtı düzenidir.
- Kerberos: İstemci bilgisayar ve sunucu, Kerberos sertifikalarını kullanarak karşılıklı olarak kimlik doğrulaması yapar.
- Anlaşma: Anlaşma, kimlik doğrulaması için kullanılacak düzeni belirlemek üzere sunucu veya ara sunucuyla anlaşmaya varan bir sınama yanıtı düzenidir. Örneğin, bu parametre değeri anlaşmanın Kerberos protokolü mü yoksa NTLM mi kullanıldığını belirlemesine olanak tanır.
- CredSSP: Kullanıcının kimlik bilgilerini temsilci olarak atamasını sağlayan Kimlik Bilgisi Güvenlik Destek Sağlayıcısı (CredSSP) kimlik doğrulamasını kullanın. Bu seçenek, bir uzak bilgisayarda çalışan ancak diğer uzak bilgisayarlardan veri toplayan veya başka komutlar çalıştıran komutlar için tasarlanmıştır.
Dikkat
CredSSP, kullanıcının kimlik bilgilerini yerel bilgisayardan uzak bir bilgisayara devreder. Bu uygulama, uzak işlemin güvenlik riskini artırır. Uzak bilgisayarın güvenliği aşılırsa, kimlik bilgileri ona geçirildiğinde, kimlik bilgileri ağ oturumunu denetlemek için kullanılabilir.
Parametre özellikleri
| Tür: | AuthenticationMechanism |
| Default value: | None |
| Kabul edilen değerler: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | yetkilendirme, am |
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 |
-CertificateThumbprint
Bu eylemi gerçekleştirme izni olan bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X509) belirtir. Sertifikanın parmak izini girin.
Sertifikalar, istemci sertifikası tabanlı kimlik doğrulamasında kullanılır. Bunlar yalnızca yerel kullanıcı hesaplarıyla eşlenebilir; etki alanı hesaplarıyla çalışmaz.
Sertifika parmak izi almak için PowerShell Cert: sürücüsündeki Get-Item veya Get-ChildItem komutunu kullanın.
Parametre özellikleri
| Tür: | String |
| 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 |
-ComputerName
Yönetim işlemini çalıştırmak istediğiniz bilgisayarı belirtir. Değer tam etki alanı adı, NetBIOS adı veya IP adresi olabilir. Yerel bilgisayar adını kullanın, localhost kullanın veya yerel bilgisayarı belirtmek için nokta (.) kullanın. Yerel bilgisayar varsayılandır. Uzak bilgisayar kullanıcıdan farklı bir etki alanında olduğunda, tam etki alanı adı kullanmanız gerekir. Bu parametre için bir değeri cmdlet'ine yöneltebilirsiniz.
Parametre özellikleri
| Tür: | String |
| Default value: | Localhost |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Çin |
Parametre kümeleri
ComputerName
| 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 |
-ConnectionURI
Bağlantı uç noktasını belirtir. Bu dizenin biçimi:
<Transport>://<Server>:<Port>/<ApplicationName>
Aşağıdaki dize, bu parametre için düzgün biçimlendirilmiş bir değerdir:
http://Server01:8080/WSMAN
URI tam olarak nitelenmiş olmalıdır.
Parametre özellikleri
| Tür: | Uri |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | CURI, CU |
Parametre kümeleri
URI
| 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 gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Varsayılan değer mevcut kullanıcıdır. "User01", "Domain01\User01" veya "User@Domain.com" gibi bir kullanıcı adı yazın. Alternatif olarak, Get-Credential cmdlet'i tarafından döndürülen nesne gibi bir PSCredential nesnesi de girin. Bir kullanıcı adı yazdığınızda parola girmeniz istenir.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | cred, c |
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: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-FilePath
Yönetim kaynağı oluşturmak için kullanılan dosyanın yolunu belirtir. yönetim kaynağını ResourceURI parametresini ve SelectorSet parametresini kullanarak belirtirsiniz. Örneğin, aşağıdaki komut Dosya parametresini kullanır:
Invoke-WSManAction -Action StopService -ResourceUri wmi/cimv2/Win32_Service -SelectorSet @{Name="spooler"} -File C:\input.xml -Authentication Default
Bu komut, bir dosyadan giriş kullanarak Biriktirici hizmetindeki StopService yöntemini çağırır.
Input.xmldosyası aşağıdaki içeriği içerir:
<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Yol |
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 |
-OptionSet
İsteğin niteliğini değiştirmek veya iyileştirmek için bir dizi anahtarı bir hizmete geçirir. Bunlar, hizmete özgü olduklarından komut satırı kabuklarında kullanılan anahtarlara benzer. Herhangi bir sayıda seçenek belirtilebilir.
Aşağıdaki örnek, a, b ve c parametreleri için 1, 2 ve 3 değerlerini geçiren söz dizimini gösterir:
-OptionSet @{a=1;b=2;c=3}
Parametre özellikleri
| Tür: | Hashtable |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | os |
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 |
-Port
İstemci WinRM hizmetine bağlandığında kullanılacak bağlantı noktasını belirtir. Aktarım HTTP olduğunda varsayılan bağlantı noktası 80'dir. Aktarım HTTPS olduğunda varsayılan bağlantı noktası 443'dür.
Aktarım olarak HTTPS kullandığınızda, ComputerName parametresinin değeri sunucunun sertifika ortak adıyla (CN) eşleşmelidir. Ancak, SkipCNCheck parametresi SessionOption parametresinin bir parçası olarak belirtilirse, sunucunun sertifika ortak adının sunucunun ana bilgisayar adıyla eşleşmesi gerekmez. SkipCNCheck parametresi yalnızca güvenilen bilgisayarlar için kullanılmalıdır.
Parametre özellikleri
| Tür: | Int32 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerName
| 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 |
-ResourceURI
Kaynak sınıfının veya örneğin Tekdüzen Kaynak Tanımlayıcısını (URI) içerir. URI, bir bilgisayardaki diskler veya işlemler gibi belirli bir kaynak türünü tanımlamak için kullanılır.
URI bir ön ek ve kaynağın yolundan oluşur. Örneğin:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor
Parametre özellikleri
| Tür: | Uri |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | ruri |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | True |
| İş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 |
-SelectorSet
Belirli yönetim kaynağı örneklerini seçmek için kullanılan değer çiftleri kümesini belirtir. SelectorSet parametresi, kaynağın birden fazla örneği mevcut olduğunda kullanılır. SelectorSet parametresinin değeri karma tablo olmalıdır.
Aşağıdaki örnekte bu parametre için bir değerin nasıl girilir gösterilmektedir:
-SelectorSet @{Name="WinRM";ID="yyy"}
Parametre özellikleri
| Tür: | Hashtable |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Ö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 |
-SessionOption
WS-Management oturumu için bir dizi genişletilmiş seçenek tanımlar.
cmdlet'ini kullanarak oluşturduğunuz bir New-WSManSessionOption nesnesi girin. Kullanılabilen seçenekler hakkında daha fazla bilgi için bkz. New-WSManSessionOption.
Parametre özellikleri
| Tür: | SessionOption |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | böyle |
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 |
-UseSSL
Uzak bilgisayara bağlantı kurmak için Güvenli Yuva Katmanı (SSL) protokolunun kullanılması gerektiğini belirtir. Varsayılan olarak SSL kullanılmaz.
WS-Management ağ üzerinden iletilen tüm Windows PowerShell içeriğini şifreler. UseSSL parametresi, HTTP yerine HTTPS'nin ek korumasını belirtmenize olanak tanır. Bağlantı için kullanılan bağlantı noktasında SSL kullanılamıyorsa ve bu parametreyi belirtirseniz, komut başarısız olur.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerName
| 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 |
-ValueSet
Bir yönetim kaynağının değiştirilmesine yardımcı olan bir karma tablo belirtir. yönetim kaynağını ResourceURI parametresini ve SelectorSet parametresini kullanarak belirtirsiniz. ValueSet parametresinin değeri karma tablo olmalıdır.
Parametre özellikleri
| Tür: | Hashtable |
| 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 |
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
XmlElement
Bu cmdlet, oluşturulan WSMan örneğini bir XmlElement nesnesi olarak döndürür.
Notlar
Windows Yönetim Araçları (WMI) cmdlet'i olan Set-WmiInstance cmdlet'i benzerdir.
Set-WmiInstance, WMI örneklerini oluşturmak veya güncelleştirmek için DCOM bağlantısı/aktarım katmanını kullanır.
