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

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í, například ComputerName, protokol použitý pro připojení, ID relace a ID instance.

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

New-CimSession

Tento příkaz 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č.

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

New-CimSession -ComputerName Server01

Tento příkaz vytvoří relaci CIM k počítači určenému ComputerName. Ve výchozím nastavení New-CimSession vytvoří relaci WsMan při ComputerName je zadán.

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

New-CimSession -ComputerName Server01,Server02,Server03

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

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

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

New-CimSession -ComputerName Server01,Server02 -Name FileServers

Get-CimSession -Name File*

Tento příkaz vytvoří vzdálenou relaci CIM pro všechny počítače 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.

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

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

Tento příkaz vytvoří relaci CIM k počítači určenému ComputerNamepomocí objektu PSCredential určenéhopřihlašovacích údajů a typ ověřování zadaný Ověřování.

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

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

New-CimSession -ComputerName Server01 -Port 1234

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

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

$SessionOption = New-CimSessionOption -Protocol DCOM

New-CimSession -ComputerName Server1 -SessionOption $SessionOption

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

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

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), ve kterém jsou přihlašovací údaje uživatele předány vzdálenému počítači, který se má ověřit, je určený pro příkazy, které vyžadují ověření 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
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 o použití zprostředkovatele certifikátu PowerShellu, typ nebo naleznete v tématuzprostředkovatel certifikátu .

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.

Můžete také předat název počítače (v uvozovkách) New-CimSession pomocí kanálu.

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 odkazu na relaci CIM při použití jiných rutin, jako je například 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, 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é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

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 pokud chcete 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

Tato rutina nepřijímá žádné vstupy.

Výstupy

CimSession