Invoke-WSManAction

Başvuru

Modül:: Microsoft.WSMan.Management

Kaynak URI'sinin ve seçicilerin belirttiği nesne üzerinde bir eylem ç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>]

Description

Invoke-WSManAction, RESOURCE_URI tarafından belirtilen nesne üzerinde, parametrelerin anahtar değer çiftleri tarafından belirtildiği 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: Yöntem ç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: Yöntem ç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.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" />

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 3: Belirtilen parametre değerlerine sahip bir yöntem ç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öntemine iki parametre değeri geçirir: Notepad.exe ve C:\. Sonuç olarak, Not Defteri'ni ç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 yöntem ç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. ComputerName parametresi belirtildiğinden, komut uzak server01 bilgisayarında ç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 nesnesi üzerinde çalıştırılacak yöntemi belirtir.

Tür:	String
Position:	1
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-ApplicationName

Bağlantıdaki uygulama adını belirtir. ApplicationName parametresinin varsayılan değeri WSMAN'dır. Uzak uç noktanın tam tanımlayıcısı aşağıdaki biçimdedir:

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

Mesela:

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 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.

Tür:	String
Position:	Named
Default value:	Wsman
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Authentication

Sunucuda kullanılacak kimlik doğrulama mekanizmasını belirtir. Olası değerler şunlardır:

Basic - Temel, kullanıcı adı ve parolanın sunucuya veya ara sunucuya düz metin olarak gönderildiği bir düzendir.
Default - WS-Management protokolü tarafından uygulanan kimlik doğrulama yöntemini kullanın. Varsayılan değer budur.
Digest - Özet, sınama için sunucuda belirtilen veri dizesini 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.
Negotiate - 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.

Tür:	AuthenticationMechanism
Diğer adlar:	auth, am
Kabul edilen değerler:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-CertificateThumbprint

Bu eylemi gerçekleştirme izni olan 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ğ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 Windows PowerShell Cert: sürücüsündeki Get-Item veya Get-ChildItem komutunu kullanın.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	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 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.

Tür:	String
Diğer adlar:	cn
Position:	Named
Default value:	Localhost
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	Uri
Diğer adlar:	CURI, CU
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Credential

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Varsayılan değer geçerli kullanıcıdır. "User01", "Domain01\User01" veya User@Domain.comgibi 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.

Tür:	PSCredential
Diğer adlar:	cred, c
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-FilePath

Bir yönetim kaynağını güncelleştirmek için kullanılan dosyanın yolunu belirtir. ResourceURI parametresini ve SelectorSet parametresini kullanarak yönetim kaynağını 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.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" />

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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}

Tür:	Hashtable
Diğer adlar:	os
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	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'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 makineler için kullanılmalıdır.

Tür:	Int32
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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. Mesela:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Tür:	Uri
Diğer adlar:	ruri
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	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 değeri bir 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"}

Tür:	Hashtable
Position:	2
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-SessionOption

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

Tür:	SessionOption
Diğer adlar:	so
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-UseSSL

Uzak bilgisayara bağlantı kurmak için Güvenli Yuva Katmanı (SSL) protokolunun 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ı 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.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-ValueSet

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

Tür:	Hashtable
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

XmlElement

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

Aracılığıyla paylaş

Invoke-WSManAction

Sözdizimi

Description

Örnekler

Örnek 1: Yöntem çağırma

Örnek 2: Yöntem çağırma

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

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

Parametreler

-Action

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-FilePath

-OptionSet

-Port

-ResourceURI

-SelectorSet

-SessionOption

-UseSSL

-ValueSet

Girişler

Çıkışlar

Ek kaynaklar

Aracılığıyla paylaş

Invoke-WSManAction

Sözdizimi

Description

Örnekler

Örnek 1: Yöntem çağırma

Örnek 2: Yöntem çağırma

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

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

Parametreler

-Action

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-FilePath

-OptionSet

-Port

-ResourceURI

-SelectorSet

-SessionOption

-UseSSL

-ValueSet

Girişler

Çıkışlar

İlişkili Bağlantılar

Ek kaynaklar