New-CimSessionOption

Składnia

ProtocolTypeSet (domyślnie)

New-CimSessionOption
    [-Protocol] <ProtocolType>
    [-UICulture <CultureInfo>]
    [-Culture <CultureInfo>]
    [<CommonParameters>]

WSManParameterSet

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

DcomParameterSet

New-CimSessionOption
    [-Impersonation <ImpersonationType>]
    [-PacketIntegrity]
    [-PacketPrivacy]
    [-UICulture <CultureInfo>]
    [-Culture <CultureInfo>]
    [<CommonParameters>]

Opis

Przykłady

Przykład 1: Tworzenie obiektu opcji sesji dla DCOM w CIM

$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so

Przykład 2: Utwórz obiekt opcji sesji CIM dla WsMan

New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl

Przykład 3: Tworzenie obiektu opcji sesji modelu CIM z określoną kulturą

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

Parametry

-Culture

Określa kulturę interfejsu, która ma być używana dla sesji CIM. Określ wartość tego parametru przy użyciu jednego z następujących formatów:

Wprowadź nazwę kultury w formacie <languagecode2>-<country/regioncode2>, takim jak "EN-US".

Zmienna zawierająca obiekt CultureInfo.

Polecenie, które pobiera obiekt CultureInfo, taki jak Get-Culture

Właściwości parametru

Zestawy parametrów

-EncodePortInServicePrincipalName

Wskazuje, że połączenie Kerberos łączy się z usługą, której główna nazwa usługi (SPN) zawiera numer portu usługi. Ten typ połączenia nie jest powszechny.

Właściwości parametru

Zestawy parametrów

-Encoding

Określa kodowanie używane dla protokołu WsMan.

Dopuszczalne wartości tego parametru to: Default, Utf8 lub Utf16.

Właściwości parametru

Zestawy parametrów

-HttpPrefix

Określa część adresu URL HTTP po nazwie komputera i numerze portu. Zmiana tego nie jest powszechna.

Domyślnie wartość tego parametru to /wsman.

Właściwości parametru

Zestawy parametrów

-Impersonation

Tworzy sesję DCOM do Instrumentacji Zarządzania Windows® (WMI) przy użyciu podszywania się.

Prawidłowe wartości dla tego parametru to:

• Ustawienie domyślne: DCOM może wybrać poziom impersonacji przy użyciu normalnego algorytmu negocjacji zabezpieczeń.
• Brak: klient jest anonimowy na serwerze. Proces serwera może personifikować klienta, ale token personifikacji nie zawiera żadnych informacji i nie może być używany.
• Zidentyfikuj: umożliwia obiektom wykonywanie zapytań dotyczących poświadczeń obiektu wywołującego.
• Personifikuj: umożliwia obiektom używanie poświadczeń wywołującego.
• Delegat: umożliwia obiektom zezwolenie innym obiektom na używanie poświadczeń obiektu wywołującego.

Jeśli nie określono personifikacji, polecenie cmdlet New-CimSession używa wartości 3: Personifikacja

Właściwości parametru

Zestawy parametrów

-MaxEnvelopeSizeKB

Określa limit rozmiaru komunikatów XML WsMan dla dowolnego kierunku.

Właściwości parametru

Zestawy parametrów

-NoEncryption

Określa, że szyfrowanie danych jest wyłączone.

Właściwości parametru

Zestawy parametrów

-PacketIntegrity

Określa, że sesja DCOM utworzona w usłudze WMI używa funkcji PacketIntegrity modelu obiektów składowych (COM). W przypadku zwiększonych zabezpieczeń domyślnie wszystkie sesje modelu CIM utworzone przy użyciu modelu DCOM mają parametr PacketIntegrity ustawiony na wartość True.

Właściwości parametru

Zestawy parametrów

-PacketPrivacy

Tworzy sesję DCOM w usłudze WMI przy użyciu funkcji COM PacketPrivacy. W przypadku zwiększonych zabezpieczeń domyślnie wszystkie sesje modelu CIM utworzone przy użyciu modelu DCOM mają parametr PacketPrivacy ustawiony na wartość true.

Właściwości parametru

Zestawy parametrów

-Protocol

Określa protokół do użycia.

Dopuszczalne wartości tego parametru to: DCOM lub WinRM.

Właściwości parametru

Zestawy parametrów

-ProxyAuthentication

Określa metodę uwierzytelniania do użycia na potrzeby rozpoznawania serwera proxy.

Dopuszczalne wartości tego parametru to: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain lub CredSsp.

Właściwości parametru

Zestawy parametrów

-ProxyCertificateThumbprint

Określa cyfrowy certyfikat klucza publicznego (x.509) dla konta użytkownika, wykorzystywany do uwierzytelniania z użyciem serwera proxy. Wprowadź odcisk palca certyfikatu.

Certyfikaty są używane w uwierzytelnianiu opartym na certyfikatach klienta. Mogą być mapowane tylko na konta użytkowników lokalnych i nie działają z kontami domeny.

Aby uzyskać odcisk palca certyfikatu, użyj poleceń cmdlet Get-Item lub Get-ChildItem w dysku Cert: programu PowerShell.

Właściwości parametru

Zestawy parametrów

-ProxyCredential

Określa poświadczenia do użycia na potrzeby uwierzytelniania serwera proxy. Wprowadź jedną z następujących wartości:

• Zmienna zawierająca obiekt PSCredential.
• Polecenie, które pobiera obiekt PSCredential, taki jak Get-Credential

Jeśli ta opcja nie jest ustawiona, nie można określić żadnych poświadczeń.

Właściwości parametru

Zestawy parametrów

-ProxyType

Określa mechanizm rozpoznawania nazw hosta do użycia.

Dopuszczalne wartości tego parametru to: None, WinHttp, Auto lub InternetExplorer.

Domyślnie wartość tego parametru to InternetExplorer.

Właściwości parametru

Zestawy parametrów

-SkipCACheck

Wskazuje, że podczas nawiązywania połączenia za pośrednictwem protokołu HTTPS klient nie sprawdza, czy certyfikat serwera jest podpisany przez zaufany urząd certyfikacji.

Użyj tego parametru tylko wtedy, gdy komputer zdalny jest zaufany przy użyciu innego mechanizmu, takiego jak gdy komputer zdalny jest częścią sieci, która jest fizycznie bezpieczna i izolowana lub gdy komputer zdalny jest wymieniony jako zaufany host w konfiguracji usługi WinRM.

Właściwości parametru

Zestawy parametrów

-SkipCNCheck

Wskazuje, że nazwa pospolita certyfikatu (CN) serwera nie musi być zgodna z nazwą hosta serwera.

Użyj tego parametru tylko w przypadku operacji zdalnych korzystających z protokołu HTTPS.

Uwaga: użyj tego parametru tylko dla zaufanych komputerów.

Właściwości parametru

Zestawy parametrów

-SkipRevocationCheck

Wskazuje, że sprawdzanie odwołania dla certyfikatów serwera jest pomijane.

Uwaga: użyj tego parametru tylko dla zaufanych komputerów.

Właściwości parametru

Zestawy parametrów

-UICulture

Określa kulturę interfejsu, która ma być używana dla sesji CIM. Określ wartość tego parametru przy użyciu jednego z następujących formatów:

• Wprowadź nazwę kultury w formacie <languagecode2>-<country/regioncode2>, takim jak "EN-US".
• Zmienna zawierająca obiekt CultureInfo.
• Polecenie, które pobiera obiekt CultureInfo, taki jak Get-Culture.

Właściwości parametru

Zestawy parametrów

-UseSsl

Wskazuje, że protokół SSL powinien służyć do nawiązywania połączenia z komputerem zdalnym. Domyślnie protokół SSL nie jest używany.

Program WsMan szyfruje całą zawartość przesyłaną przez sieć. Ten parametr umożliwia określenie dodatkowej ochrony protokołu HTTPS zamiast protokołu HTTP. Jeśli protokół SSL nie jest dostępny na porcie używanym dla połączenia i określisz ten parametr, polecenie zakończy się niepowodzeniem.

Zaleca się użycie tego parametru tylko wtedy, gdy parametr PacketPrivacy nie jest określony.

Właściwości parametru

Zestawy parametrów

CommonParameters

Dane wejściowe

None

Dane wyjściowe

CIMSessionOption

Linki powiązane

• Get-ChildItem
• Get-Credential
• Get-Culture
• Get-Item
• New-CimSession