New-CimSessionOption
New-CimSession cmdlet'i için gelişmiş seçenekleri belirtir.
Syntax
New-CimSessionOption
[-Protocol] <ProtocolType>
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>] New-CimSessionOption
[-NoEncryption]
[-SkipCACheck]
[-SkipCNCheck]
[-SkipRevocationCheck]
[-EncodePortInServicePrincipalName]
[-Encoding <PacketEncoding>]
[-HttpPrefix <Uri>]
[-MaxEnvelopeSizeKB <UInt32>]
[-ProxyAuthentication <PasswordAuthenticationMechanism>]
[-ProxyCertificateThumbprint <String>]
[-ProxyCredential <PSCredential>]
[-ProxyType <ProxyType>]
[-UseSsl]
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>] New-CimSessionOption
[-Impersonation <ImpersonationType>]
[-PacketIntegrity]
[-PacketPrivacy]
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>] Description
Bu cmdlet yalnızca Windows platformunda kullanılabilir.
New-CimSessionOption Cmdlet, CIM oturum seçenekleri nesnesinin bir örneğini oluşturur. CIM oturumu seçeneklerini belirtmek için cmdlet'ine New-CimSession giriş olarak CIM oturum seçenekleri nesnesi kullanırsınız.
Bu cmdlet'in biri WsMan seçenekleri, diğeri Dağıtılmış Bileşen Nesne Modeli (DCOM) seçenekleri için olan iki parametre kümesi vardır. Hangi parametreleri kullandığınıza bağlı olarak, cmdlet DCOM oturum seçeneklerinin bir örneğini veya WsMan oturum seçeneklerini döndürür.
Örnekler
Örnek 1: DCOM için CIM oturum seçenekleri nesnesi oluşturma
Bu örnek, DCOM protokolü için bir CIM oturum seçenekleri nesnesi oluşturur ve adlı bir değişkende $sodepolar. Değişkenin içeriği daha sonra cmdlet'ine New-CimSession geçirilir.
New-CimSession ardından, değişkende tanımlanan seçenekleri kullanarak Server01 adlı uzak sunucuyla yeni bir CIM oturumu oluşturur.
$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $soÖrnek 2: WsMan için CIM oturum seçenekleri nesnesi oluşturma
Bu örnek, WsMan protokolü için bir CIM oturum seçenekleri nesnesi oluşturur. nesnesi, ProxyAuthentication parametresi tarafından belirtilen Kerberos kimlik doğrulama modunun yapılandırmasını, ProxyCredential parametresi tarafından belirtilen kimlik bilgilerini içerir ve komutun CA denetimini atlamak, CN denetimini atlamak ve SSL kullanmak olduğunu belirtir.
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSslÖrnek 3: Belirtilen kültüre sahip bir CIM oturum seçenekleri nesnesi oluşturma
New-CimSessionOption -Culture Fr-Fr -Protocol WsmanBu örnek CIM oturumu için kullanılan kültürü belirtir. Varsayılan olarak, işlemleri gerçekleştirirken istemcinin kültürü kullanılır. Ancak, Culture parametresi kullanılarak varsayılan kültür geçersiz kılınabilir.
Parametreler
-Culture
CIM oturumu için kullanılacak kullanıcı arabirimi kültürünü belirtir. Aşağıdaki biçimlerden birini kullanarak bu parametrenin değerini belirtin:
- "EN-US" gibi biçimde bir
<languagecode2>-<country/regioncode2>kültür adı. - CultureInfo nesnesi içeren bir değişken.
- Get-Culture gibi bir CultureInfo nesnesi alan komut
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EncodePortInServicePrincipalName
Kerberos bağlantısının hizmet asıl adı (SPN) hizmet bağlantı noktası numarasını içeren bir hizmete bağlandığını gösterir. Bu tür bir bağlantı yaygın değildir.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Encoding
WsMan protokolü için kullanılan kodlamayı belirtir. Bu parametre için kabul edilebilir değerler şunlardır: Default, Utf8 veya Utf16.
| Type: | PacketEncoding |
| Accepted values: | Default, Utf8, Utf16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HttpPrefix
HTTP URL'sinin bilgisayar adı ve bağlantı noktası numarasından sonraki bölümünü belirtir. Bunu değiştirmek yaygın değildir. Varsayılan olarak, bu parametrenin değeri /wsman'dır.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Impersonation
Kimliğe bürünme kullanarak Windows Yönetim Araçları'na (WMI) bir DCOM oturumu oluşturur.
Bu parametre için geçerli değerler:
- Varsayılan: DCOM, normal güvenlik anlaşması algoritmasını kullanarak kimliğe bürünme düzeyini seçebilir.
- Hiçbiri: İstemci sunucuya anonimdir. Sunucu işlemi istemcinin kimliğine bürünebilir, ancak kimliğe bürünme belirteci herhangi bir bilgi içermez ve kullanılamaz.
- Tanımla: Nesnelerin çağıranın kimlik bilgilerini sorgulamasına izin verir.
- Kimliğe Bürün: Nesnelerin çağıranın kimlik bilgilerini kullanmasına izin verir.
- Temsilci: Nesnelerin diğer nesnelerin çağıranın kimlik bilgilerini kullanmasına izin vermesine izin verir.
Kimliğe Bürünme belirtilmezse, New-CimSession cmdlet'i Kimliğe Bürün değerini kullanır.
| Type: | ImpersonationType |
| Accepted values: | Default, None, Identify, Impersonate, Delegate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxEnvelopeSizeKB
WsMan XML iletilerinin boyut sınırını her iki yönde de belirtir.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NoEncryption
Veri şifrelemenin kapalı olduğunu belirtir.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PacketIntegrity
WMI için oluşturulan DCOM oturumunun Bileşen Nesne Modeli (COM) PacketIntegrity işlevini kullandığını belirtir. Varsayılan olarak, DCOM kullanılarak oluşturulan tüm CIM oturumlarında PacketIntegrity parametresi True olarak ayarlanmıştır.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PacketPrivacy
COM PacketPrivacy kullanarak WMI için bir DCOM oturumu oluşturur. Varsayılan olarak, DCOM kullanılarak oluşturulan tüm CIM oturumlarında PacketPrivacy parametresi true olarak ayarlanmıştır.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
Kullanılacak protokolü belirtir. Bu parametre için kabul edilebilir değerler şunlardır: DCOM, Default veya Wsman.
| Type: | ProtocolType |
| Accepted values: | Dcom, Default, Wsman |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyAuthentication
Ara sunucu çözümlemesi için kullanılacak kimlik doğrulama yöntemini belirtir. Bu parametre için kabul edilebilir değerler şunlardır: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain veya CredSsp.
| 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 |
-ProxyCertificateThumbprint
Ara sunucu kimlik doğrulaması için bir kullanıcı hesabının (x.509) dijital ortak anahtar sertifikasını 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 ve etki alanı hesaplarıyla çalışmaz.
Sertifika parmak izi almak için PowerShell Cert: sürücüsündeki veya Get-ChildItem cmdlet'lerini kullanınGet-Item.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
Proxy kimlik doğrulaması için kullanılacak kimlik bilgilerini belirtir. Aşağıdakilerden birini girin:
- PSCredential nesnesi içeren bir değişken.
- PSCredential nesnesi alan bir komut, örneğin
Get-Credential
Bu seçenek ayarlanmadıysa, hiçbir kimlik bilgisi belirtemezsiniz.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProxyType
Kullanılacak ana bilgisayar adı çözümleme mekanizmasını belirtir. Bu parametre için kabul edilebilir değerler şunlardır: None, WinHttp, Auto veya InternetExplorer.
Bu parametrenin varsayılan değeri InternetExplorer'dır.
| Type: | ProxyType |
| Accepted values: | None, WinHttp, Auto, InternetExplorer |
| Position: | Named |
| Default value: | InternetExplorer |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipCACheck
HTTPS üzerinden bağlanırken istemcinin sunucu sertifikasının güvenilen bir sertifika yetkilisi (CA) tarafından imzalandığını doğrulamadığını gösterir.
Bu parametreyi yalnızca uzak bilgisayar fiziksel olarak güvenli ve yalıtılmış bir ağın parçası olduğunda veya uzak bilgisayar WinRM yapılandırmasında güvenilir bir konak olarak listelendiğinde olduğu gibi başka bir mekanizma kullanılarak güvenilir olduğunda kullanın.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipCNCheck
Sunucunun sertifika ortak adının (CN) sunucunun ana bilgisayar adıyla eşleşmesi gerekmediğini gösterir. Uzak işlemler için bu parametreyi yalnızca HTTPS protokolunu kullanan güvenilir bilgisayarlarla kullanın.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipRevocationCheck
Sunucu sertifikaları için iptal denetiminin atlandığını gösterir. Bu parametreyi yalnızca güvenilen bilgisayarlar için kullanın.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UICulture
CIM oturumu için kullanılacak kullanıcı arabirimi kültürünü belirtir. Aşağıdaki biçimlerden birini kullanarak bu parametrenin değerini belirtin:
- "EN-US" gibi biçimde bir
<languagecode2>-<country/regioncode2>kültür adı. - CultureInfo nesnesi içeren bir değişken.
- gibi
Get-Culturebir CultureInfo nesnesi alan bir komut.
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UseSsl
Uzak bilgisayara bağlantı kurmak için SSL kullanılması gerektiğini gösterir. Varsayılan olarak SSL kullanılmaz. WsMan, HTTP kullanırken bile ağ üzerinden iletilen tüm içeriği şifreler.
Bu parametre, 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.
Bu parametreyi yalnızca PacketPrivacy parametresi belirtilmediğinde kullanmanız önerilir.
| 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
Bu cmdlet, CIM oturum seçenekleri bilgilerini içeren bir nesne döndürür.
Notlar
PowerShell için aşağıdaki diğer adları New-CimSessionOptioniçerir:
- Windows:
ncso
Bu cmdlet yalnızca Windows platformlarında kullanılabilir.
İlişkili Bağlantılar
PowerShell
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin