New-CimSession

Składnia

CredentialParameterSet (Domyślna)

New-CimSession
    [[-Credential] <PSCredential>]
    [[-ComputerName] <String[]>]
    [-Authentication <PasswordAuthenticationMechanism>]
    [-Name <String>]
    [-OperationTimeoutSec <UInt32>]
    [-SkipTestConnection]
    [-Port <UInt32>]
    [-SessionOption <CimSessionOptions>]
    [<CommonParameters>]

CertificateParameterSet

New-CimSession
    [[-ComputerName] <String[]>]
    [-CertificateThumbprint <String>]
    [-Name <String>]
    [-OperationTimeoutSec <UInt32>]
    [-SkipTestConnection]
    [-Port <UInt32>]
    [-SessionOption <CimSessionOptions>]
    [<CommonParameters>]

Opis

Przykłady

Przykład 1. Tworzenie sesji modelu CIM z opcjami domyślnymi

New-CimSession

Przykład 2. Tworzenie sesji modelu ciM na określonym komputerze

New-CimSession -ComputerName Server01

Przykład 3. Tworzenie sesji modelu cim na wielu komputerach

New-CimSession -ComputerName Server01, Server02, Server03

Przykład 4. Tworzenie sesji modelu CIM z przyjazną nazwą

New-CimSession -ComputerName Server01, Server02 -Name FileServers
Get-CimSession -Name File*

Przykład 5. Tworzenie sesji modelu CIM na komputerze przy użyciu obiektu PSCredential

New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate

Przykład 6. Tworzenie sesji ciM na komputerze przy użyciu określonego portu

New-CimSession -ComputerName Server01 -Port 1234

Przykład 7. Tworzenie sesji modelu CIM przy użyciu modelu DCOM

$SessionOption = New-CimSessionOption -Protocol Dcom
New-CimSession -ComputerName Server1 -SessionOption $SessionOption

Parametry

-Authentication

Określa typ uwierzytelniania używany dla poświadczeń użytkownika. Dopuszczalne wartości tego parametru to:

• Wartość domyślna
• Podsumowanie
• Negocjacja
• Basic
• Kerberos
• Domena_Ntlm
• Zaufanie Ssp

Nie można użyć typu uwierzytelniania NtlmDomain na potrzeby połączenia z komputerem lokalnym. uwierzytelnianie credSSP jest dostępne tylko w systemach Windows Vista, Windows Server 2008 i nowszych wersjach systemu Windows.

Właściwości parametru

Zestawy parametrów

-CertificateThumbprint

Określa certyfikat cyfrowego klucza publicznego (X.509) konta użytkownika, które ma uprawnienia do wykonania tej akcji. Wprowadź odcisk palca certyfikatu.

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

Aby uzyskać odcisk palca certyfikatu, użyj poleceń cmdlet Get-Item lub Get-ChildItem w dostawcy certyfikatów programu PowerShell.

Aby uzyskać więcej informacji, zobacz about_Certificate_Provider.

Właściwości parametru

Zestawy parametrów

-ComputerName

Określa nazwę komputera, do którego ma zostać utworzona sesja modelu CIM. Określ pojedynczą nazwę komputera lub wiele nazw komputerów rozdzielonych przecinkami.

Jeśli ComputerName nie zostanie określona, zostanie utworzona sesja modelu CIM na komputerze lokalnym. Można określić wartość nazwy komputera w jednym z następujących formatów:

• Co najmniej jedna nazwa NetBIOS
• Co najmniej jeden adres IP
• Co najmniej jedna w pełni kwalifikowana nazwa domeny.

Jeśli komputer znajduje się w innej domenie niż użytkownik, musisz określić w pełni kwalifikowaną nazwę domeny.

Właściwości parametru

Zestawy parametrów

-Credential

Określa konto użytkownika, które ma uprawnienia do wykonania tej akcji. Jeśli poświadczenie nie zostanie określone, zostanie użyte bieżące konto użytkownika.

Określ wartość Credential przy użyciu jednego z następujących formatów:

• Nazwa użytkownika: "User01"
• Nazwa domeny i nazwa użytkownika: "Domain01\User01"
• Główna nazwa użytkownika: "User@Domain.com"
• Obiekt PSCredential, taki jak jeden zwrócony przez polecenie cmdlet Get-Credential.

Podczas wpisywania nazwy użytkownika zostanie wyświetlony monit o podanie hasła.

Właściwości parametru

Zestawy parametrów

-Name

Określa przyjazną nazwę sesji modelu CIM.

Możesz użyć nazwy , aby odwołać się do sesji modelu ciM podczas korzystania z innych poleceń cmdlet, takich jak Get-CimSession polecenia cmdlet. Nazwa nie musi być unikatowa dla komputera ani bieżącej sesji.

Właściwości parametru

Zestawy parametrów

-OperationTimeoutSec

Czas trwania, dla którego polecenie cmdlet czeka na odpowiedź z serwera.

Domyślnie wartość tego parametru to 0, co oznacza, że polecenie cmdlet używa domyślnej wartości limitu czasu dla serwera.

Jeśli parametr OperationTimeoutSec jest ustawiony na wartość mniejszą niż limit czasu ponawiania próby niezawodnego połączenia przez 3 minuty, awarie sieci, które trwają dłużej niż wartość parametru OperationTimeoutSec nie są możliwe do odzyskania, ponieważ operacja na serwerze przekracza limit czasu, zanim klient będzie mógł ponownie nawiązać połączenie.

Właściwości parametru

Zestawy parametrów

-Port

Określa port sieciowy na komputerze zdalnym używanym na potrzeby tego połączenia. Aby nawiązać połączenie z komputerem zdalnym, komputer zdalny musi nasłuchiwać na porcie używanym przez połączenie. Domyślne porty to 5985 (port Usługi WinRM dla protokołu HTTP) i 5986 (port Usługi WinRM dla protokołu HTTPS).

Przed użyciem portu alternatywnego należy skonfigurować odbiornik WinRM na komputerze zdalnym do nasłuchiwania na tym porcie. Aby skonfigurować odbiornik, użyj następujących poleceń:

winrm delete winrm/config/listener?Address=*+Transport=HTTP

winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number>"}

Nie używaj parametru portów , chyba że musisz. Ustawienie portu w poleceniu ma zastosowanie do wszystkich komputerów lub sesji, na których jest uruchamiane polecenie. Ustawienie alternatywnego portu może uniemożliwić uruchomienie polecenia na wszystkich komputerach.

Właściwości parametru

Zestawy parametrów

-SessionOption

Ustawia zaawansowane opcje dla nowej sesji modelu CIM. Wprowadź nazwę obiektu CimSessionOption utworzonego przy użyciu polecenia cmdlet New-CimSessionOption.

Właściwości parametru

Zestawy parametrów

-SkipTestConnection

Domyślnie polecenie cmdlet New-CimSession ustanawia połączenie z zdalnym punktem końcowym WS-Management z dwóch powodów: aby sprawdzić, czy serwer zdalny nasłuchuje na numerze portu określonym przy użyciu parametru Port i sprawdzić określone poświadczenia konta. Weryfikacja jest przeprowadzana przy użyciu standardowej operacji WS-Identity. Możesz dodać parametr przełącznika SkipTestConnection, jeśli zdalny punkt końcowy WS-Management nie może użyć funkcji WS-Identify lub skrócić czas transmisji danych.

Właściwości parametru

Zestawy parametrów

CommonParameters

Dane wejściowe

None

Dane wyjściowe

CimSession

Uwagi

Linki powiązane

• Get-ChildItem
• Get-Credential
• Get-Item
• Get-CimSession
• Usuń-CimSession
• New-CimSessionOption
• informacje_o_CimSession