Udostępnij za pośrednictwem

New-CimSessionOption

  • Odwołanie
Moduł:
CimCmdlets

Określa opcje zaawansowane 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 ciM. Obiekt opcji sesji ciM jest używany jako dane wejściowe polecenia cmdlet, New-CimSession aby określić opcje sesji ciM.

To polecenie cmdlet ma dwa zestawy parametrów, jeden dla opcji WsMan i jeden dla opcji Modelu obiektów składników rozproszonych (DCOM). W zależności od parametrów, które są używane, polecenie cmdlet zwraca wystąpienie opcji sesji DCOM lub zwraca opcje sesji WsMan.

Przykłady

Przykład 1: Twórca obiektu opcji sesji modelu CIM 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 do New-CimSession polecenia cmdlet. New-CimSession następnie tworzy nową sesję 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 ciM dla programu WsMan

W tym przykładzie zostanie utworzony obiekt opcji sesji 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 cn i użyć protokołu SSL.

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

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

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

W tym przykładzie określono kulturę używaną dla sesji ciągłej integracji. Domyślnie kultura klienta jest używana podczas wykonywania operacji. Jednak domyślna kultura może zostać zastąpiona przy użyciu parametru Culture .

Parametry

-Culture

Określa kulturę interfejsu użytkownika do użycia dla sesji 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 , na przykład 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 do 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.
  • Identyfikowanie: 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ładników (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 modelu CIM 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 używaną do 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 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 na dysku Programu PowerShell Cert:.

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 hosta 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 (CA).

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.

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 do użycia dla sesji 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ść, która jest przesyłana 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 kończy się niepowodzeniem.

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

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

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

CimSessionOptions

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

Uwagi

Program PowerShell zawiera następujące aliasy dla New-CimSessionOptionprogramu :

  • W systemie Windows:
    • ncso

To polecenie cmdlet jest dostępne tylko na platformach systemu Windows.