Invoke-WSManAction (Microsoft.WSMan.Management)

Invoke-WSManAction

Modül:
Microsoft.WSMan.Management

Kaynak URI'si ve seçiciler tarafından belirtilen nesne üzerinde bir eylemi çağırır.

Sözdizimi

Invoke-WSManAction
      [-Action] <String>
      [-ConnectionURI <Uri>]
      [-FilePath <String>]
      [-OptionSet <Hashtable>]
      [[-SelectorSet] <Hashtable>]
      [-SessionOption <SessionOption>]
      [-ValueSet <Hashtable>]
      [-ResourceURI] <Uri>
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]
Invoke-WSManAction
      [-Action] <String>
      [-ApplicationName <String>]
      [-ComputerName <String>]
      [-FilePath <String>]
      [-OptionSet <Hashtable>]
      [-Port <Int32>]
      [[-SelectorSet] <Hashtable>]
      [-SessionOption <SessionOption>]
      [-UseSSL]
      [-ValueSet <Hashtable>]
      [-ResourceURI] <Uri>
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]

Tanım

Bu cmdlet yalnızca Windows platformunda mevcuttur.

Invoke-WSManAction, parametrelerin anahtar değer çiftleri tarafından belirtildiği RESOURCE_URI tarafından belirtilen nesne üzerinde bir eylem çalıştırır.

Bu cmdlet, eylemi çalıştırmak için WSMan bağlantı/aktarım katmanını kullanır.

Örnekler

Örnek 1: Bir yöntemi çağırma

Invoke-WSManAction -Action startservice -ResourceURI wmicimv2/win32_service  -SelectorSet @{name="spooler"} -Authentication default

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ReturnValue : 0

Bu komut, Biriktirici hizmetine karşılık gelen Win32_Service WMI sınıfı örneğinin StartService yöntemini çağırır.

Dönüş değeri eylemin başarılı olup olmadığını gösterir. Bu durumda 0 dönüş değeri başarıyı gösterir. 5 dönüş değeri, hizmetin zaten başlatıldığını gösterir.

Örnek 2: Bir yöntemi çağırma

Invoke-WSManAction -Action stopservice -ResourceURI wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:input.xml -Authentication default

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ReturnValue : 0

Bu komut, bir dosyadaki girişi kullanarak Biriktirici hizmetindeki StopService yöntemini çağırır. Input.xml dosyası 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" />

Örnek 3: Belirtilen parametre değerlerine sahip bir yöntemi çağırma

Invoke-WSManAction -Action create -ResourceURI wmicimv2/win32_process -ValueSet @{commandline="notepad.exe";currentdirectory="C:\"}

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Process
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ProcessId   : 6356
ReturnValue : 0

Bu komut, Win32_Process sınıfının Create yöntemini çağırır. Yönteme iki parametre değeri aktarır: Notepad.exe ve C:\. Sonuç olarak, Notepad'i çalıştırmak için yeni bir işlem oluşturulur ve yeni işlemin geçerli dizini C:\ olarak ayarlanır.

Örnek 4: Uzak bilgisayarda bir yöntemi çağırma

Invoke-WSManAction -Action startservice -ResourceURI wmicimv2/win32_service  -SelectorSet @{name="spooler"} -ComputerName server01 -Authentication default

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ReturnValue : 0

Bu komut, Biriktirici hizmetine karşılık gelen Win32_Service WMI sınıfı örneğinin StartService yöntemini çağırır. BilgisayarAdı parametresi belirtildiği için komut, uzak sunucu01 bilgisayarına karşı çalışır.

Dönüş değeri eylemin başarılı olup olmadığını gösterir. Bu durumda 0 dönüş değeri başarıyı gösterir. 5 dönüş değeri, hizmetin zaten başlatıldığını gösterir.

Parametreler

-Action

ResourceURI ve seçiciler tarafından belirtilen yönetim nesnesinde çalıştırılacak yöntemi belirtir.

Tip :

String

Konum:

1

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ApplicationName

Bağlantıdaki uygulama adını belirtir. ApplicationName parametresinin varsayılan değeri WSMAN'dir. 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. Bu varsayılan "WSMAN" ayarı çoğu kullanım için uygundur. Bu parametre, çok sayıda bilgisayar Windows PowerShell çalıştıran bir bilgisayara uzaktan bağlantı kurduğunda kullanılmak üzere tasarlanmıştır. Bu durumda IIS, verimlilik amacıyla Yönetim için Web Hizmetlerini (WS-Yönetim) barındırır.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

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 proxy'ye açık metin olarak gönderildiği bir şemadır.
  • Varsayılan - WS-Management protokolü tarafından uygulanan kimlik doğrulama yöntemini kullanın. Bu varsayılandır.
  • Digest - Digest, sorgulama için sunucu tarafından belirlenen bir veri dizesini kullanan bir sorgulama-yanıt şemasıdır.
  • Kerberos - İstemci bilgisayar ve sunucu, Kerberos sertifikalarını kullanarak karşılıklı olarak kimlik doğrulaması yapar.
  • Anlaşma - Anlaşma, kimlik doğrulama için kullanılacak şemayı belirlemek üzere sunucu veya proxy ile anlaşan bir sorgulama-yanıt şemasıdır. Örneğin, bu parametre değeri, Kerberos protokolünün mü yoksa NTLM'nin mi kullanıldığını belirlemek için anlaşma yapılmasına olanak tanır.
  • CredSSP - Kullanıcının kimlik bilgilerini devretmesine olanak tanıyan Kimlik Bilgisi Güvenliği Destek Sağlayıcısı (CredSSP) kimlik doğrulamasını kullanın. Bu seçenek, uzak bir bilgisayarda çalışan ancak diğer uzak bilgisayarlardan veri toplayan veya ek 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 uzaktan operasyonun güvenlik riskini artırmaktadır. Uzak bilgisayarın güvenliği ihlal edilirse, kimlik bilgileri bu bilgisayara iletildiğinde, kimlik bilgileri ağ oturumunu kontrol etmek için kullanılabilir.

Tip :

AuthenticationMechanism

Takma adlar:

auth, am

Kabul edilen değerler:

Yok, Varsayılan, Özet, Anlaşma, Temel, Kerberos, ClientCertificate, Credssp

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-CertificateThumbprint

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X509) belirtir. Sertifikanın sertifika parmak izini girin.

Sertifikalar, istemci sertifikası tabanlı kimlik doğrulamada kullanılır. Yalnızca yerel kullanıcı hesaplarıyla eşlenebilirler; etki alanı hesaplarıyla çalışmazlar.

Sertifika parmak izi almak için Windows PowerShell Cert: sürücüsündeki Get-Item veya Get-ChildItem komutunu kullanın.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

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ı belirtmek için yerel bilgisayar adını kullanın, localhost kullanın veya bir nokta (.) kullanın. Yerel bilgisayar varsayılandır. Uzak bilgisayar kullanıcıdan farklı bir etki alanında olduğunda, tam nitelikli bir etki alanı adı kullanılmalıdır. Bu parametre için bir değeri cmdlet'e aktarabilirsiniz.

Tip :

String

Takma adlar:

cn

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ConnectionURI

Bağlantı uç noktasını belirtir. Bu dizenin formatı şöyledir:

<Transport>://<Server>:<Port>/<ApplicationName>

Aşağıdaki dize bu parametre için uygun şekilde biçimlendirilmiş bir değerdir:

http://Server01:8080/WSMAN

URI tam olarak nitelenmiş olmalıdır.

Tip :

Uri

Takma adlar:

CURI, CU

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Credential

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabını belirtir. Varsayılan geçerli kullanıcıdır. "Kullanıcı01", "EtkiAlanı01\Kullanıcı01" veya Kullanıcı@EtkiAlanı.com gibi bir kullanıcı adı yazın. Veya Get-Credential cmdlet'inin döndürdüğü gibi bir PSCredential nesnesi girin. Kullanıcı adını yazdığınızda sizden şifre istenecektir.

Tip :

PSC kimlik bilgisi

Takma adlar:

cred, c

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-FilePath

Bir yönetim kaynağını güncellemek 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 FilePath parametresini kullanır:

Invoke-WSManAction -Action stopservice -ResourceUri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath c:\input.xml -Authentication default

Bu komut, bir dosyadaki girişi kullanarak Biriktirici hizmetindeki StopService yöntemini çağırır. Input.xml dosyası 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" />
Tip :

String

Takma adlar:

Path

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-OptionSet

İsteğin doğasını değiştirmek veya iyileştirmek için bir hizmete bir dizi anahtar iletir. Bunlar, hizmete özel oldukları için 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 ileten söz dizimini gösterir:

-OptionSet @{a=1;b=2;c=3}
Tip :

Karma tablo

Takma adlar:

os

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

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'tü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. SkipCNCeck parametresi yalnızca güvenilir makineler için kullanılmalıdır.

Tip :

Int32

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ResourceURI

Kaynak sınıfının veya örneğinin Tekdüzen Kaynak Tanımlayıcısını (URI) içerir. URI, bilgisayardaki diskler veya işlemler gibi belirli bir kaynak türünü tanımlamak için kullanılır.

Bir URI, bir önek ve bir kaynağa giden yoldan 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
Tip :

Uri

Takma adlar:

ruri

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-SelectorSet

Belirli yönetim kaynağı örneklerini seçmek için kullanılan değer çiftleri kümesini belirtir. SelectorSet, kaynağın birden fazla örneği mevcut olduğunda kullanılır. SelectorSet'in değeri bir karma tablosu olmalıdır.

Aşağıdaki örnek, bu parametre için nasıl değer girileceğini gösterir:

-SelectorSet @{Name="WinRM";ID="yyy"}
Tip :

Karma tablo

Konum:

2

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-SessionOption

WS-Management oturumu için bir dizi genişletilmiş seçeneği tanımlar. New-WSManSessionOption cmdlet'ini kullanarak oluşturduğunuz bir SessionOption nesnesini girin. Kullanılabilir seçenekler hakkında daha fazla bilgi için bkz. New-WSManSessionOption.

Tip :

SessionOption

Takma adlar:

so

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-UseSSL

Uzak bilgisayarla bağlantı kurmak için Güvenli Yuva Katmanı (SSL) protokolünün kullanıldığını belirtir. Varsayılan olarak SSL kullanılmaz.

WS-Management, ağ üzerinden iletilen tüm PowerShell içeriğini şifreler. UseSSL parametresi, HTTP yerine HTTPS'nin ek korumasını belirlemenizi sağlar. Bağlantı için kullanılan portta SSL yoksa ve bu parametreyi belirtirseniz komut başarısız olur.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ValueSet

Bir yönetim kaynağının değiştirilmesine yardımcı olan bir karma tablosu belirtir. Yönetim kaynağını ResourceURI ve SelectorSet parametrelerini kullanarak belirtirsiniz. ValueSet parametresinin değeri bir karma tablosu olmalıdır.

Tip :

Karma tablo

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

Yok

Nesneleri bu cmdlet'e aktaramazsınız.

Çıkışlar

XmlElement

Bu cmdlet, işlemin sonucunu bir XmlElement nesnesi olarak döndürür.

İlgili makaleler