New-CimSessionOption

Składnia

ProtocolTypeSet (Domyślna)

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

$option = @{
    ProxyAuthentication = 'Kerberos'
    ProxyCredential = $cred
    SkipCACheck = $true
    SkipCNCheck = $true
    UseSsl = $true
}
New-CimSessionOption @option

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:

• Nazwa 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, Utf8lub 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 Personifikacja, polecenie cmdlet New-CimSession używa wartości Personifikuj.

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 przez WMI używa funkcji Modelu obiektów składników (COM) PacketIntegrity. 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 do usługi WMI przy użyciu PacketPrivacyCOM. 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, Defaultlub Wsman.

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: Domyślne, Digest, Negotiate, Basic, Kerberos, NtlmDomainlub 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, Autolub InternetExplorer.

Wartość domyślna 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 dla operacji zdalnych tylko z zaufanymi komputerami korzystającymi z protokołu HTTPS.

Właściwości parametru

Zestawy parametrów

-SkipRevocationCheck

Wskazuje, że sprawdzanie odwołania dla certyfikatów serwera jest pomijane. 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:

• Nazwa 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ć, nawet w przypadku korzystania z protokołu HTTP.

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 nie określono parametru PacketPrivacy.

Właściwości parametru

Zestawy parametrów

CommonParameters

Dane wejściowe

None

Dane wyjściowe

CimSessionOptions

Uwagi

Linki powiązane

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