New-CimSession

  • Referencia
Modul:
CimCmdlets

Létrehoz egy CIM-munkamenetet.

Syntax

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

Ez a parancsmag csak a Windows platformon érhető el.

A New-CimSession parancsmag létrehoz egy CIM-munkamenetet. A CIM-munkamenet egy ügyféloldali objektum, amely egy helyi számítógéphez vagy távoli számítógéphez való kapcsolatot jelöl. A CIM-munkamenet információkat tartalmaz a kapcsolatról, például a ComputerName-ről, a használt protokollról vagy különböző azonosítókról.

Ez a parancsmag egy CIM-munkamenetobjektumot ad vissza, amelyet az összes többi CIM-parancsmag használhat.

Példák

1. példa: CIM-munkamenet létrehozása alapértelmezett beállításokkal

Ez a példa létrehoz egy helyi CIM-munkamenetet alapértelmezett beállításokkal. Ha a ComputerName nincs megadva, New-CimSession létrehoz egy DCOM-munkamenetet a helyi számítógépen.

New-CimSession

2. példa: CIM-munkamenet létrehozása egy adott számítógépen

Ez a példa létrehoz egy CIM-munkamenetet a ComputerName által megadott számítógépen. A ComputerName megadásakor alapértelmezés szerint New-CimSession létrehoz egy WSMan-munkamenetet.

New-CimSession -ComputerName Server01

3. példa: CIM-munkamenet létrehozása több számítógépen

Ez a példa létrehoz egy CIM-munkamenetet a ComputerName által megadott számítógépeken a vesszővel tagolt listában.

New-CimSession -ComputerName Server01,Server02,Server03

4. példa: CIM-munkamenet létrehozása rövid névvel

Ez a példa létrehoz egy távoli CIM-munkamenetet a ComputerName által megadott számítógépekre a vesszővel tagolt listában, és a Név beállításával egy rövid nevet rendel az új munkamenetekhez.

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

A CIM-munkamenetek felhasználóbarát nevével hivatkozhat a munkamenetre más CIM-parancsmagokban, például a Get-CimSession parancsmagokban.

5. példa: CIM-munkamenet létrehozása a számítógépen PSCredential objektum használatával

Ez a példa létrehoz egy CIM-munkamenetet a ComputerName által megadott számítógépen a hitelesítő adatok által megadott PSCredential objektummal és a hitelesítés által megadott hitelesítési típussal.

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

PSCredential objektumot a Get-Credential parancsmaggal hozhat létre.

6. példa: CIM-munkamenet létrehozása a számítógépen egy adott port használatával

Ez a példa létrehoz egy CIM-munkamenetet a ComputerName által megadott számítógépen a port által megadott TCP-port használatával.

New-CimSession -ComputerName Server01 -Port 1234

7. példa: CIM-munkamenet létrehozása a DCOM használatával

Ez a példa egy CIM-munkamenetet hoz létre a WSMan helyett az Elosztott COM (DCOM) protokoll használatával.

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

Paraméterek

-Authentication

Megadja a felhasználó hitelesítő adataihoz használt hitelesítési típust. A paraméter elfogadható értékei a következők:

  • Alapértelmezett
  • Digest
  • Tárgyalni
  • Alap
  • Kerberos
  • NtlmDomain
  • CredSsp

A helyi számítógéphez való csatlakozáshoz nem használhatja az NtlmDomain hitelesítési típust. A CredSSP-hitelesítés csak a Windows Vista, a Windows Server 2008 és a Windows újabb verzióiban érhető el.

Figyelemfelhívás

A Credential Security Service Provider (CredSSP) hitelesítés olyan parancsokhoz készült, amelyek több erőforráson is hitelesítést igényelnek, például távoli hálózati megosztáshoz való hozzáféréshez. Ez a mechanizmus növeli a távoli művelet biztonsági kockázatát. Ha a távoli számítógép biztonsága sérül, a neki átadott hitelesítő adatokkal szabályozható a hálózati munkamenet.

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

-CertificateThumbprint

Megadja egy olyan felhasználói fiók digitális nyilvános kulcsú tanúsítványát (X.509), amely jogosult a művelet végrehajtására. Adja meg a tanúsítvány ujjlenyomatát.

A tanúsítványok az ügyféltanúsítvány-alapú hitelesítésben használatosak. Ezek csak helyi felhasználói fiókokra képezhetők le; nem működnek tartományi fiókokkal.

Tanúsítvány ujjlenyomatának lekéréséhez használja a Get-ItemGet-ChildItem PowerShell-tanúsítványszolgáltató parancsmagjait.

További információ: about_Certificate_Provider.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Megadja annak a számítógépnek a nevét, amelyhez létre kívánja hozni a CIM-munkamenetet. Adjon meg egyetlen számítógépnevet, vagy több számítógépnevet vesszővel elválasztva.

Ha a ComputerName nincs megadva, a rendszer létrehoz egy CIM-munkamenetet a helyi számítógépen. A számítógép nevének értékét az alábbi formátumok egyikében adhatja meg:

  • Egy vagy több NetBIOS-név
  • Egy vagy több IP-cím
  • Egy vagy több teljes tartománynév.

Ha a számítógép más tartományban van, mint a felhasználó, meg kell adnia a teljes tartománynevet.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Ha nincs megadva hitelesítő adat , a rendszer az aktuális felhasználói fiókot használja.

Adja meg a hitelesítő adatok értékét az alábbi formátumok egyikével:

  • Felhasználónév: "User01"
  • Tartománynév és felhasználónév: "Domain01\User01"
  • Egyszerű felhasználónév: "User@Domain.com"
  • PSCredential objektum, például a Get-Credential parancsmag által visszaadott objektum.

Amikor beír egy felhasználónevet, a rendszer jelszót kér.

Type:PSCredential
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

A CIM-munkamenet rövid nevét adja meg.

A névvel hivatkozhat a CIM-munkamenetre más parancsmagok, például a Get-CimSession parancsmag használatakor. A névnek nem kell egyedinek lennie a számítógépen vagy az aktuális munkamenetben.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OperationTimeoutSec

Az időtartam, amelyre a parancsmag a kiszolgáló válaszára vár.

Alapértelmezés szerint ennek a paraméternek az értéke 0, ami azt jelenti, hogy a parancsmag a kiszolgáló alapértelmezett időtúllépési értékét használja.

Ha az OperationTimeoutSec paraméter értéke kisebb, mint a robusztus kapcsolat újrapróbálkozási időtúllépése 3 perc, akkor az OperationTimeoutSec paraméter értékénél hosszabb hálózati hibák nem állíthatók helyre, mert a kiszolgálón végzett művelet túllépi az időkorlátot, mielőtt az ügyfél újracsatlakozhat.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Port

A kapcsolathoz használt hálózati portot adja meg a távoli számítógépen. Távoli számítógéphez való csatlakozáshoz a távoli számítógépnek a kapcsolat által használt portot kell figyelnie. Az alapértelmezett portok a következők: 5985 (HTTP WinRM-port) és 5986 (a HTTPS WinRM-portja).

Egy másik port használata előtt konfigurálnia kell a WinRM-figyelőt a távoli számítógépen az adott port figyelésére. A figyelő konfigurálásához használja az alábbi parancsokat:

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

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

Csak akkor használja a Port paramétert, ha kötelező. A parancs portbeállítása minden olyan számítógépre vagy munkamenetre vonatkozik, amelyen a parancs fut. Egy másik portbeállítás megakadályozhatja, hogy a parancs minden számítógépen fusson.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SessionOption

Speciális beállításokat ad meg az új CIM-munkamenethez. Adja meg a parancsmaggal New-CimSessionOption létrehozott CimSessionOption objektum nevét.

Type:CimSessionOptions
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SkipTestConnection

A parancsmag alapértelmezés szerint New-CimSession két okból hoz létre kapcsolatot egy távoli WS-Management-végponttal: annak ellenőrzéséhez, hogy a távoli kiszolgáló figyeli-e a Port paraméterrel megadott portszámot, és hogy ellenőrizze a megadott fiók hitelesítő adatait. Az ellenőrzés egy szabványos WS-Identity művelettel történik. Hozzáadhatja a SkipTest Csatlakozás ion kapcsoló paramétert, ha a távoli WS-Management végpont nem tudja használni a WS-Identify szolgáltatást, vagy csökkentheti az adatátviteli időt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

CimSession

Ez a parancsmag egy CIM-munkamenetobjektumot ad vissza.

Jegyzetek

A PowerShell a következő aliasokat New-CimSessiontartalmazza:

  • Windows:
    • ncms

Ez a parancsmag csak Windows-platformokon érhető el.