New-CimSession
CIM oturumu oluşturur.
Syntax
CredentialParameterSet (Varsayılan)
New-CimSession
[[-Credential] <PSCredential>]
[[-ComputerName] <String[]>]
[-Authentication <PasswordAuthenticationMechanism>]
[-Name <String>]
[-OperationTimeoutSec <UInt32>]
[-SkipTestConnection]
[-Port <UInt32>]
[-SessionOption <CimSessionOptions>]
[<CommonParameters>]
CertificateParameterSet
New-CimSession
[[-ComputerName] <String[]>]
[-CertificateThumbprint <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, ComputerName, kullanılan protokol veya çeşitli tanımlayıcılar gibi bağlantı hakkında bilgi 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, ComputerNametarafından belirtilen bilgisayara bir CIM oturumu oluşturur.
Varsayılan olarak, New-CimSessionComputerName 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ış listesinde ComputerNametarafından belirtilen bilgisayarların her biri için bir CIM oturumu oluşturur.
New-CimSession -ComputerName Server01, Server02, Server03
Örnek 4: Kolay hatırlanabilir adla CIM oturumu oluşturma
Bu örnek, virgülle ayrılmış bir listede belirtilen ComputerNamebilgisayarlarının her birine bir uzak CIM oturumu oluşturur ve yeni oturumlara, Adıbelirterek kullanıcı dostu 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 başvurabilirsiniz; örneğin, Get-CimSession.
Örnek 5: PSCredential nesnesi kullanarak bir bilgisayarda CIM oturumu başlatma
Bu örnek, Credentialtarafından belirtilen PSCredential nesnesini ve Authenticationtarafından belirtilen kimlik doğrulama türünü kullanarak ComputerNametarafından belirtilen bilgisayara bir CIM oturumu oluşturur.
New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate
cmdlet'ini kullanarak Get-Credential nesnesi oluşturabilirsiniz.
Örnek 6: Belirli bir bağlantı noktasını kullanarak bir bilgisayara CIM oturumu oluşturma
Bu örnek, ComputerName tarafından belirtilen bilgisayara, Porttarafından belirtilen TCP bağlantı noktasını kullanarak bir CIM oturumu başlatır.
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 parametre için kabul edilebilir değerler şunlardır:
- Varsayılan
- Özet
- Anlaşma
- Temel
- Kerberos Gölü
- 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 sonraki Windows 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.
Parametre özellikleri
| Tür: | PasswordAuthenticationMechanism |
| Default value: | None |
| Kabul edilen değerler: | Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
CredentialParameterSet
| 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 |
-CertificateThumbprint
Bu eylemi gerçekleştirme izni olan bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X.509) 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 Sertifika Sağlayıcısı'ndaki Get-Item veya Get-ChildItem cmdlet'lerini kullanın.
Daha fazla bilgi için bkz. about_Certificate_Provider.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
CertificateParameterSet
| 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 |
-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 alan adı.
Bilgisayar kullanıcıdan farklı bir etki alanındaysa, tam nitelikli etki alanı adını belirtmelisiniz.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Çin, SunucuAdı |
Parametre kümeleri
(All)
| Position: | 1 |
| 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 |
-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 Bilgisi değerini belirtin:
- Kullanıcı adı: "User01"
- Etki alanı adı ve kullanıcı adı: "Domain01\User01"
- Kullanıcı asıl adı: "User@Domain.com"
- PSCredential nesnesi,
Get-Credentialcmdlet'i tarafından döndürülen bir nesne gibi.
Bir kullanıcı adı yazdığınızda parola girmeniz istenir.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
CredentialParameterSet
| Position: | 2 |
| 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 |
-Name
CIM oturumu için kullanıcı dostu 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.
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: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | UInt32 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | OT |
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 |
-Port
Bu bağlantı için kullanılan uzak bilgisayardaki ağ bağlantı noktasını belirtir. Uzak bilgisayara bağlanmak için, uzak bilgisayarın, bağlantının kullanıldığı bağlantı noktasını dinliyor olması gerekir. 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>"}
Bağlantı Noktası parametresini gerekmedikçe 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.
Parametre özellikleri
| Tür: | UInt32 |
| 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: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-SessionOption
Yeni CIM oturumu için gelişmiş seçenekleri ayarlar.
cmdlet'i kullanılarak oluşturulan New-CimSessionOption nesnesinin adını girin.
Parametre özellikleri
| Tür: | CimSessionOptions |
| 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: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-SkipTestConnection
Varsayılan olarak, New-CimSession cmdlet'i iki nedenden dolayı uzak WS-Management uç noktasıyla bağlantı kurar: 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. 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 kısaltmak için SkipTestConnection anahtar parametresini ekleyebilirsiniz.
Parametre özellikleri
| Tür: | SwitchParameter |
| 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: | True |
| 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
CimSession
Bu cmdlet bir CIM oturum nesnesi döndürür.
Notlar
PowerShell, New-CimSessioniçin aşağıdaki diğer adları içerir:
- Windows:
ncms
Bu cmdlet yalnızca Windows platformlarında kullanılabilir.
