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 ComputerName, 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 není zadaný ComputerName, 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í New-CimSession vytvoří relaci WSMan při 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ý z počítačů určených 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 pro každý počítač určený ComputerName, v seznamu odděleném čárkami a přiřadí popisný název k novým relacím zadáním Název.

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 ComputerNamepomocí objektu PSCredential určeným přihlašovacích údajůa typ ověřování určený ověřování .

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

Pomocí rutiny Get-Credential můžete vytvořit objekt PSCredential.

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 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. Přijatelné hodnoty pro tento parametr jsou:

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

Pro připojení k místnímu počítači nelze použít typ ověřování NtlmDomain. 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.

Opatrnost

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 nebo Get-ChildItem ve zprostředkovateli certifikátu PowerShellu.

Další informace naleznete 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ý 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 není zadaný přihlašovacích údajů, 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, například rutiny 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, selhání sítě, která trvala více než hodnota parametru OperationTimeoutSec, není možné 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>"}

Nepoužívejte parametr Port, pokud není nutné. 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ý 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

Rutina New-CimSession ve výchozím nastavení vytvoří připojení ke vzdálenému koncovému bodu WS-Management ze dvou důvodů: ověření, že vzdálený server naslouchá na čísle portu zadaném pomocí parametru Port a ověření zadaných přihlašovacích údajů úč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.