Sdílet prostřednictvím

New-CimSession

  • Reference
Modul:
CimCmdlets

Vytvoří relaci CIM.

Syntaxe

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

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina New-CimSession vytvoří relaci CIM. Relace CIM je objekt na straně klienta představující připojení k místnímu počítači nebo vzdálenému počítači. Relace CIM obsahuje informace o připojení, jako je název počítače, použitý protokol nebo různé identifikátory.

Tato rutina vrátí objekt relace CIM, který může používat všechny ostatní rutiny CIM.

Příklady

Příklad 1: Vytvoření relace CIM s výchozími možnostmi

Tento příklad vytvoří místní relaci CIM s výchozími možnostmi. Pokud parametr ComputerName není zadaný, New-CimSession vytvoří relaci modelu DCOM pro místní počítač.

New-CimSession

Příklad 2: Vytvoření relace CIM pro konkrétní počítač

Tento příklad vytvoří relaci CIM k počítači určenému ComputerName. Ve výchozím nastavení vytvoří relaci WSMan při New-CimSession zadání Název_počítače .

New-CimSession -ComputerName Server01

Příklad 3: Vytvoření relace CIM pro více počítačů

Tento příklad vytvoří relaci CIM pro každý počítač určený ComputerName v seznamu odděleném čárkami.

New-CimSession -ComputerName Server01,Server02,Server03

Příklad 4: Vytvoření relace CIM s popisným názvem

Tento příklad vytvoří vzdálenou relaci CIM ke každému počítači určenému názvem ComputerName, v seznamu odděleném čárkami a přiřadí popisný název k novým relacím zadáním názvu.

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

Popisný název relace CIM můžete použít k odkazování na relaci v jiných rutinách CIM, například Get-CimSession.

Příklad 5: Vytvoření relace CIM k počítači pomocí objektu PSCredential

Tento příklad vytvoří relaci CIM k počítači určenému ComputerName pomocí objektu PSCredential určeného pověřením a typu ověřování určeného ověřováním.

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

Objekt PSCredential můžete vytvořit pomocí rutinyGet-Credential.

Příklad 6: Vytvoření relace CIM pro počítač pomocí konkrétního portu

Tento příklad vytvoří relaci CIM k počítači určenému ComputerName pomocí portu TCP určeného portem Port.

New-CimSession -ComputerName Server01 -Port 1234

Příklad 7: Vytvoření relace CIM pomocí modelu DCOM

Tento příklad vytvoří relaci CIM pomocí protokolu DCOM (Distributed COM) místo WSMan.

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

Parametry

-Authentication

Určuje typ ověřování, který se používá pro přihlašovací údaje uživatele. Tento parametr přijímá tyto hodnoty:

  • Výchozí
  • Trávit
  • Vyjednávat
  • Basic
  • Kerberos
  • NtlmDomain
  • CredSsp

Typ ověřování NtlmDomain nelze použít pro připojení k místnímu počítači. Ověřování CredSSP je k dispozici pouze v systémech Windows Vista, Windows Server 2008 a novějších verzích systému Windows.

Upozornění

Ověřování zprostředkovatele služby CredSSP (Credential Security Service Provider) je určeno pro příkazy, které vyžadují ověřování u více než jednoho prostředku, například pro přístup ke vzdálené síťové sdílené složce. Tento mechanismus zvyšuje riziko zabezpečení vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, dají se k řízení síťové relace použít přihlašovací údaje, které jsou mu předány.

Typ:PasswordAuthenticationMechanism
Přípustné hodnoty:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-CertificateThumbprint

Určuje certifikát digitálního veřejného klíče (X.509) uživatelského účtu, který má oprávnění k provedení této akce. Zadejte kryptografický otisk certifikátu.

Certifikáty se používají při ověřování na základě klientských certifikátů. Mohou být mapovány pouze na místní uživatelské účty; nefungují s doménovými účty.

Pokud chcete získat kryptografický otisk certifikátu, použijte rutiny Get-Item Get-ChildItem ve zprostředkovateli certifikátů PowerShellu.

Další informace najdete v tématu about_Certificate_Provider.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ComputerName

Určuje název počítače, do kterého se má vytvořit relace CIM. Zadejte název jednoho počítače nebo několik názvů počítačů oddělených čárkou.

Pokud není zadaný název ComputerName , vytvoří se relace CIM k místnímu počítači. Hodnotu názvu počítače můžete zadat v jednom z následujících formátů:

  • Jeden nebo více názvů rozhraní NetBIOS
  • Jedna nebo více IP adres
  • Jeden nebo více plně kvalifikovaných názvů domén.

Pokud je počítač v jiné doméně než uživatel, musíte zadat plně kvalifikovaný název domény.

Typ:String[]
Aliasy:CN, ServerName
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Pokud nejsou zadané přihlašovací údaje , použije se aktuální uživatelský účet.

Zadejte hodnotu přihlašovacích údajů pomocí jednoho z následujících formátů:

  • Uživatelské jméno: User01
  • Název domény a uživatelské jméno: Domain01\User01
  • Hlavní název uživatele: "User@Domain.com"
  • Objekt PSCredential, například objekt vrácený rutinou Get-Credential .

Když zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.

Typ:PSCredential
Position:2
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje popisný název relace CIM.

Název můžete použít k odkazování na relaci CIM při použití jiných rutin, jako je rutina Get-CimSession . Název nemusí být jedinečný pro počítač nebo aktuální relaci.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-OperationTimeoutSec

Doba trvání, po kterou rutina čeká na odpověď ze serveru.

Ve výchozím nastavení je hodnota tohoto parametru 0, což znamená, že rutina používá výchozí hodnotu časového limitu pro server.

Pokud je parametr OperationTimeoutSec nastaven na hodnotu menší než robustní časový limit opakování připojení 3 minuty, chyby sítě, které trvaly více než hodnota parametru OperationTimeoutSec, se nedají obnovit, protože operace na serveru vyprší, než se klient může znovu připojit.

Typ:UInt32
Aliasy:OT
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Port

Určuje síťový port na vzdáleném počítači, který se používá pro toto připojení. Pokud se chcete připojit ke vzdálenému počítači, musí vzdálený počítač naslouchat na portu, který připojení používá. Výchozí porty jsou 5985 (port WinRM pro HTTP) a 5986 (port WinRM pro HTTPS).

Před použitím alternativního portu musíte nakonfigurovat naslouchací proces WinRM na vzdáleném počítači tak, aby naslouchal na tomto portu. Ke konfiguraci naslouchacího procesu použijte následující příkazy:

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

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

Parametr Port nepoužívejte, pokud ho nepotřebujete. Nastavení portu v příkazu platí pro všechny počítače nebo relace, na kterých se příkaz spouští. Alternativní nastavení portu může zabránit spuštění příkazu na všech počítačích.

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SessionOption

Nastaví upřesňující možnosti pro novou relaci CIM. Zadejte název objektu CimSessionOption vytvořeného pomocí rutiny New-CimSessionOption .

Typ:CimSessionOptions
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SkipTestConnection

Ve výchozím nastavení rutina vytvoří připojení ke vzdálenému koncovému bodu SLUŽBY WS-Management ze dvou důvodů: ověření, New-CimSession že vzdálený server naslouchá na čísle portu zadaném pomocí parametru Port a ověří zadané přihlašovací údaje účtu. Ověření se provádí pomocí standardní operace WS-Identity. Parametr přepínače SkipTestConnection můžete přidat, pokud vzdálený koncový bod WS-Management nemůže použít WS-Identify nebo zkrátit dobu přenosu dat.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

CimSession

Tato rutina vrátí objekt relace CIM.

Poznámky

PowerShell obsahuje následující aliasy pro New-CimSession:

  • Windows:
    • ncms

Tato rutina je dostupná jenom na platformách Windows.