New-CimSessionOption
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
Polecenie New-CimSessionOption
cmdlet tworzy wystąpienie obiektu opcji sesji modelu CIM. Obiekt opcji sesji modelu 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 obiektów składników rozproszonych (DCOM). 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. Tworzenie 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ę modelu CIM 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. Tworzenie obiektu opcji sesji modelu CIM dla programu 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 cn i użyć protokołu SSL.
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
W tym przykładzie określono kulturę używaną do 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 dla 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 , 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 w instrumentacji zarządzania Windows (WMI) przy użyciu personifikacji.
Prawidłowe wartości dla 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 personifikacja nie jest określona, 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 modelu CIM 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 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
na 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 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.
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 dla 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 dla 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życie 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
Nie można potokować obiektów do tego polecenia cmdlet.
Dane wyjściowe
To polecenie cmdlet zwraca obiekt zawierający informacje o opcjach sesji modelu CIM.
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla