Aracılığıyla paylaş


Remove-WSManInstance

Bir yönetim kaynağı örneğini siler.

Syntax

Remove-WSManInstance
      [-ApplicationName <String>]
      [-ComputerName <String>]
      [-OptionSet <Hashtable>]
      [-Port <Int32>]
      [-ResourceURI] <Uri>
      [-SelectorSet] <Hashtable>
      [-SessionOption <SessionOption>]
      [-UseSSL]
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]
Remove-WSManInstance
      [-ConnectionURI <Uri>]
      [-OptionSet <Hashtable>]
      [-ResourceURI] <Uri>
      [-SelectorSet] <Hashtable>
      [-SessionOption <SessionOption>]
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

cmdlet'i ResourceURI Remove-WSManInstance ve SelectorSet parametrelerinde belirtilen bir yönetim kaynağının örneğini siler.

Bu cmdlet, yönetim kaynağı örneğini silmek için WinRM bağlantı aktarım katmanını kullanır.

Örnekler

Örnek 1: Dinleyici silme

Remove-WSManInstance -ResourceUri winrm/config/Listener -SelectorSet @{
    Address   = 'test.fabrikam.com'
    Transport = 'http'
}

Bu komut bir bilgisayardaki WS-Management HTTP dinleyicisini siler.

Parametreler

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

Örneğin: http://server01:8080/WSMAN

Oturumu barındıran Internet Information Services (IIS), bu uç nokta ile istekleri belirtilen uygulamaya iletir. WSMAN'ın bu varsayılan ayarı çoğu kullanım için uygundur. Bu parametre, birçok bilgisayar Windows PowerShell çalıştıran bir bilgisayara uzak bağlantılar kurarsa kullanılacak şekilde tasarlanmıştır. Bu durumda IIS, verimlilik için Yönetim için Web Hizmetleri'ni (WS-Management) barındırmaktadır.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Authentication

Sunucuda kullanılacak kimlik doğrulama mekanizmasını belirtir. Bu parametrenin kabul edilebilir değerleri ş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. Bu varsayılan seçenektir.
  • Digest - Özet, sınama için sunucu tarafından 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.
  • Negotiate - Anlaşma, kimlik doğrulaması için kullanılacak düzeni belirlemek üzere sunucu veya ara sunucuyla anlaşma sağlayan bir sınama yanıtı şemasıdır. Ö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ına olanak tanıyan Kimlik Bilgisi Güvenlik Desteği 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ı 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.

Type:AuthenticationMechanism
Aliases:auth, am
Accepted values:None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Sertifikalar etki alanı hesaplarıyla çalışmaz.

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Yönetim işleminin çalıştırıldığı 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.

Type:String
Aliases:cn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionURI

Bağlantı uç noktasını belirtir. Bu dizenin biçimi aşağıdaki gibidir:

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

Aşağıdaki dize, bu parametre için doğru biçimlendirilmiş bir değerdir:

http://Server01:8080/WSMAN

URI tam olarak nitelenmiş olmalıdır.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Varsayılan, mevcut kullanıcıdır. , Domain01\User01veya User@Domain.comgibi User01bir kullanıcı adı yazın. Alternatif olarak, cmdlet'i tarafından Get-Credential döndürülen nesne gibi bir PSCredential nesnesi de girin. Bir kullanıcı adı yazdığınızda, bu cmdlet sizden parola ister.

Type:PSCredential
Aliases:cred, c
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OptionSet

İsteğin niteliğini değiştirmek veya iyileştirmek için bir hizmete geçiş kümesi belirtir. 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}

Type:Hashtable
Aliases:os
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceURI

Kaynak sınıfının veya örneğin URI'sini belirtir. 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

Type:Uri
Aliases:ruri
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 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"}

Type:Hashtable
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SessionOption

WS-Management oturumu için genişletilmiş seçenekleri belirtir. New-WSManSessionOption cmdlet'ini kullanarak oluşturduğunuz bir SessionOption nesnesi girin. Kullanılabilir seçenekler hakkında daha fazla bilgi için yazın Get-Help New-WSManSessionOption.

Type:SessionOption
Aliases:so
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 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.

Type:SwitchParameter
Aliases:ssl
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

CimCmdlets modülündeki cmdlet'ler benzerdir. WMI örneklerini oluşturmak veya güncelleştirmek için DCOM bağlantı/aktarım katmanını kullanırlar.