New-CimSession

  • Başvuru
Modül:
CimCmdlets

CIM oturumu oluşturur.

Syntax

New-CimSession
   [-Authentication <PasswordAuthenticationMechanism>]
   [[-Credential] <PSCredential>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]
New-CimSession
   [-CertificateThumbprint <String>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

New-CimSession Cmdlet bir CIM oturumu oluşturur. CIM oturumu, yerel bir bilgisayara veya uzak bilgisayara bağlantıyı temsil eden istemci tarafı bir nesnedir. CIM oturumu, bağlantı hakkında ComputerName, kullanılan protokol veya çeşitli tanımlayıcılar gibi bilgiler içerir.

Bu cmdlet, diğer tüm CIM cmdlet'leri tarafından kullanılabilecek bir CIM oturum nesnesi döndürür.

Örnekler

Örnek 1: Varsayılan seçeneklerle CIM oturumu oluşturma

Bu örnek, varsayılan seçeneklerle yerel bir CIM oturumu oluşturur. ComputerName belirtilmezse, New-CimSession yerel bilgisayarda bir DCOM oturumu oluşturur.

New-CimSession

Örnek 2: Belirli bir bilgisayara CIM oturumu oluşturma

Bu örnek, ComputerName tarafından belirtilen bilgisayara bir CIM oturumu oluşturur. Varsayılan olarak, New-CimSession ComputerName belirtildiğinde bir WSMan oturumu oluşturur.

New-CimSession -ComputerName Server01

Örnek 3: Birden çok bilgisayara CIM oturumu oluşturma

Bu örnek, virgülle ayrılmış listede ComputerName tarafından belirtilen bilgisayarların her biri için bir CIM oturumu oluşturur.

New-CimSession -ComputerName Server01,Server02,Server03

Örnek 4: Kolay adla CIM oturumu oluşturma

Bu örnek, BilgisayarAdı tarafından belirtilen bilgisayarların her birine virgülle ayrılmış listede bir uzak CIM oturumu oluşturur ve Ad belirterek yeni oturumlara kolay bir ad atar.

New-CimSession -ComputerName Server01,Server02 -Name FileServers
Get-CimSession -Name File*

CiM oturumunun kolay adını kullanarak diğer CIM cmdlet'lerindeki oturuma (örneğin Get-CimSession) başvurabilirsiniz.

Örnek 5: PSCredential nesnesi kullanarak bir bilgisayara CIM oturumu oluşturma

Bu örnek, Credential tarafından belirtilen PSCredential nesnesini ve Authentication tarafından belirtilen kimlik doğrulama türünü kullanarak ComputerName tarafından belirtilen bilgisayara bir CIM oturumu oluşturur.

New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate

cmdlet'ini kullanarak Get-Credential bir PSCredential nesnesi oluşturabilirsiniz.

Örnek 6: Belirli bir bağlantı noktasını kullanarak bir bilgisayara CIM oturumu oluşturma

Bu örnek, Bağlantı Noktası tarafından belirtilen TCP bağlantı noktasını kullanarak ComputerName tarafından belirtilen bilgisayara bir CIM oturumu oluşturur.

New-CimSession -ComputerName Server01 -Port 1234

Örnek 7: DCOM kullanarak CIM oturumu oluşturma

Bu örnek, WSMan yerine Dağıtılmış COM (DCOM) protokolünün kullanıldığı bir CIM oturumu oluşturur.

$SessionOption = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server1 -SessionOption $SessionOption

Parametreler

-Authentication

Kullanıcının kimlik bilgileri için kullanılan kimlik doğrulama türünü belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • Varsayılan
  • Özet
  • Anlaşma
  • Temel
  • Kerberos
  • NtlmDomain
  • Credssp

Yerel bilgisayara bağlantı için NtlmDomain kimlik doğrulama türünü kullanamazsınız. CredSSP kimlik doğrulaması yalnızca Windows Vista, Windows Server 2008 ve windows'un sonraki sürümlerinde kullanılabilir.

Dikkat

Kimlik Bilgisi Güvenlik Hizmeti Sağlayıcısı (CredSSP) kimlik doğrulaması, uzak ağ paylaşımına erişme gibi birden fazla kaynakta kimlik doğrulaması gerektiren komutlar için tasarlanmıştır. Bu mekanizma, uzak işlemin güvenlik riskini artırır. Uzak bilgisayarın güvenliği aşılırsa, bu bilgisayara geçirilen kimlik bilgileri ağ oturumunu denetlemek için kullanılabilir.

Type:PasswordAuthenticationMechanism
Accepted values:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CertificateThumbprint

Bu eylemi gerçekleştirme izni olan bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X.509) 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 PowerShell Sertifika Sağlayıcısı'ndaki veya Get-ChildItem cmdlet'lerini kullanınGet-Item.

Daha fazla bilgi için bkz . about_Certificate_Provider.

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

-ComputerName

CIM oturumunun oluşturulacağı bilgisayarın adını belirtir. Tek bir bilgisayar adı veya virgülle ayrılmış birden çok bilgisayar adı belirtin.

ComputerName belirtilmezse, yerel bilgisayarda bir CIM oturumu oluşturulur. Bilgisayar adı değerini aşağıdaki biçimlerden birinde belirtebilirsiniz:

  • Bir veya daha fazla NetBIOS adı
  • Bir veya daha fazla IP adresi
  • Bir veya daha fazla tam etki alanı adı.

Bilgisayar kullanıcıdan farklı bir etki alanındaysa, tam etki alanı adını belirtmeniz gerekir.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Kimlik Bilgisi belirtilmezse geçerli kullanıcı hesabı kullanılır.

Aşağıdaki biçimlerden birini kullanarak Kimlik Bilgileri değerini belirtin:

  • Kullanıcı adı: "User01"
  • Etki alanı adı ve kullanıcı adı: "Domain01\User01"
  • Kullanıcı asıl adı: "User@Domain.com"
  • Cmdlet tarafından Get-Credential döndürülen nesne gibi bir PSCredential nesnesi.

Bir kullanıcı adı yazdığınızda parola girmeniz istenir.

Type:PSCredential
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

CIM oturumu için kolay bir ad belirtir.

Get-CimSession cmdlet'i gibi diğer cmdlet'leri kullanırken CIM oturumuna başvurmak için bu adı kullanabilirsiniz. Adın bilgisayara veya geçerli oturuma özgü olması gerekmez.

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

-OperationTimeoutSec

Cmdlet'in sunucudan yanıt beklediği süre.

Varsayılan olarak, bu parametrenin değeri 0'dır; bu da cmdlet'in sunucu için varsayılan zaman aşımı değerini kullandığı anlamına gelir.

OperationTimeoutSec parametresi 3 dakikalık sağlam bağlantı yeniden deneme zaman aşımından daha küçük bir değere ayarlanırsa, istemci yeniden bağlanamadan önce sunucudaki işlem zaman aşımına uğraması nedeniyle OperationTimeoutSec parametresinin değerinden daha uzun süren ağ hataları kurtarılamaz.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Port

Bu bağlantı için kullanılan uzak bilgisayardaki ağ bağlantı noktasını belirtir. Uzak bilgisayara bağlanmak için, uzak bilgisayar bağlantının kullandığı bağlantı noktasında dinliyor olmalıdır. Varsayılan bağlantı noktaları 5985 (HTTP için WinRM bağlantı noktası) ve 5986 'dır (HTTPS için WinRM bağlantı noktası).

Alternatif bir bağlantı noktası kullanmadan önce, uzak bilgisayardaki WinRM dinleyicisini bu bağlantı noktasını dinleyecek şekilde yapılandırmanız gerekir. Dinleyiciyi yapılandırmak için aşağıdaki komutları kullanın:

winrm delete winrm/config/listener?Address=*+Transport=HTTP

winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number>"}

Gerekmedikçe Port parametresini kullanmayın. Komuttaki bağlantı noktası ayarı, komutun çalıştığı tüm bilgisayarlar veya oturumlar için geçerlidir. Alternatif bir bağlantı noktası ayarı, komutun tüm bilgisayarlarda çalışmasını engelleyebilir.

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

-SessionOption

Yeni CIM oturumu için gelişmiş seçenekleri ayarlar. cmdlet'i kullanılarak oluşturulan CimSessionOption nesnesinin New-CimSessionOption adını girin.

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

-SkipTestConnection

Varsayılan olarak, New-CimSession cmdlet uzak WS-Management uç noktasıyla bağlantı kurmasının iki nedeni vardır: Uzak sunucunun Bağlantı Noktası parametresi kullanılarak belirtilen bağlantı noktası numarasını dinlediğini doğrulamak ve belirtilen hesap kimlik bilgilerini doğrulamak için. Doğrulama, standart bir WS-Identity işlemi kullanılarak gerçekleştirilir. Uzak WS-Management uç noktası WS-Identify kullanamıyorsa veya veri iletim süresini azaltmak için SkipTest Bağlan ion anahtar parametresini ekleyebilirsiniz.

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

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

CimSession

Bu cmdlet bir CIM oturum nesnesi döndürür.

Notlar

PowerShell için aşağıdaki diğer adları New-CimSessioniçerir:

  • Windows:
    • ncms

Bu cmdlet yalnızca Windows platformlarında kullanılabilir.