Udostępnij za pośrednictwem

New-CimSessionOption

  • Odwołanie
Moduł:
CimCmdlets

Określa opcje zaawansowane dla polecenia cmdlet New-CimSession.

Składnia

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

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie New-CimSessionOption cmdlet tworzy wystąpienie obiektu opcji sesji modelu ciM. Obiekt opcji sesji ciM jest używany jako dane wejściowe New-CimSession polecenia cmdlet, aby określić opcje sesji modelu ciM.

To polecenie cmdlet ma dwa zestawy parametrów: jeden dla opcji WsMan i jeden dla opcji modelu DCOM (Distributed Component Object Model). W zależności od używanych parametrów polecenie cmdlet zwraca wystąpienie opcji sesji DCOM lub zwraca opcje sesji WsMan.

Przykłady

Przykład 1: Twórca obiektu opcji sesji modelu ciągłej integracji dla modelu DCOM

W tym przykładzie tworzony jest obiekt opcji sesji modelu ciM dla protokołu DCOM i przechowuje go w zmiennej o nazwie $so. Zawartość zmiennej jest następnie przekazywana New-CimSession do polecenia cmdlet . New-CimSession następnie tworzy nową sesję modelu ciągłej integracji z serwerem zdalnym o nazwie Server01 przy użyciu opcji zdefiniowanych w zmiennej.

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

Przykład 2: Twórca obiektu opcji sesji modelu ciM dla narzędzia WsMan

W tym przykładzie tworzony jest obiekt opcji sesji modelu CIM dla protokołu WsMan. Obiekt zawiera konfigurację trybu uwierzytelniania Protokołu Kerberos określonego przez parametr ProxyAuthentication , poświadczenia określone przez parametr ProxyCredential i określa, że polecenie ma pominąć sprawdzanie urzędu certyfikacji, pominąć sprawdzanie nazwy pospolitej i użyć protokołu SSL.

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

Przykład 3: Twórca obiektu opcji sesji modelu integracji z określoną kulturą

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

W tym przykładzie określono kulturę używaną dla sesji modelu CIM. Domyślnie kultura klienta jest używana podczas wykonywania operacji. Można jednak zastąpić kulturę domyślną przy użyciu parametru Culture .

Parametry

-Culture

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

  • Nazwa kultury w <languagecode2>-<country/regioncode2> formacie, takim jak "EN-US".
  • Zmienna zawierająca obiekt CultureInfo .
  • Polecenie, które pobiera obiekt CultureInfo , taki jak Get-Culture
Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

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

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

-Encoding

Określa kodowanie używane dla protokołu WsMan. Dopuszczalne wartości tego parametru to: Default, Utf8 lub Utf16.

Type:PacketEncoding
Accepted values:Default, Utf8, Utf16
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

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

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

-Impersonation

Tworzy sesję DCOM w instrumentacji zarządzania Windows (WMI) przy użyciu personifikacji.

Prawidłowe wartości tego parametru to:

  • Ustawienie domyślne: model DCOM może wybrać poziom personifikacji 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ń obiektu 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 , New-CimSession polecenie cmdlet używa wartości Personifikuj.

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

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

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

-NoEncryption

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

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

-PacketIntegrity

Określa, że sesja DCOM utworzona w usłudze WMI używa funkcji PacketIntegrity modelu obiektów składowych (COM). Domyślnie wszystkie sesje ciągłej integracji utworzone przy użyciu modelu DCOM mają parametr PacketIntegrity ustawiony na wartość True.

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

-PacketPrivacy

Tworzy sesję DCOM w usłudze WMI przy użyciu funkcji COM PacketPrivacy. Domyślnie wszystkie sesje ciągłej integracji utworzone przy użyciu modelu DCOM mają parametr PacketPrivacy ustawiony na wartość true.

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

-Protocol

Określa protokół do użycia. Dopuszczalne wartości tego parametru to : DCOM, Default lub Wsman.

Type:ProtocolType
Accepted values:Dcom, Default, Wsman
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

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

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

Określa (x.509) cyfrowy certyfikat klucza publicznego konta użytkownika na potrzeby uwierzytelniania 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 Get-Item poleceń cmdlet lub Get-ChildItem w dysku Certyfikat programu PowerShell.

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

-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, na przykład Get-Credential

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

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

-ProxyType

Określa mechanizm rozpoznawania nazw hostów do użycia. Dopuszczalne wartości tego parametru to : None, WinHttp, Auto lub InternetExplorer.

Wartość domyślna tego parametru to InternetExplorer.

Type:ProxyType
Accepted values:None, WinHttp, Auto, InternetExplorer
Position:Named
Default value:InternetExplorer
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-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 odizolowana lub gdy komputer zdalny jest wymieniony jako zaufany host w konfiguracji usługi WinRM.

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

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

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

-SkipRevocationCheck

Wskazuje, że sprawdzanie odwołania certyfikatów serwera jest pomijane. Użyj tego parametru tylko dla zaufanych komputerów.

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

-UICulture

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

  • Nazwa kultury w <languagecode2>-<country/regioncode2> formacie, takim jak "EN-US".
  • Zmienna zawierająca obiekt CultureInfo.
  • Polecenie, które pobiera obiekt CultureInfo, taki jak Get-Culture.
Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UseSsl

Wskazuje, że protokół SSL powinien służyć do nawiązywania połączenia z komputerem zdalnym. Domyślnie nie jest używane szyfrowanie SSL. 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żywanie tego parametru tylko wtedy, gdy parametr PacketPrivacy nie jest określony.

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

Dane wejściowe

None

To polecenie cmdlet nie akceptuje żadnych obiektów wejściowych.

Dane wyjściowe

CIMSessionOption

To polecenie cmdlet zwraca obiekt zawierający informacje o opcjach sesji modelu ciM.