New-CimSession

Modul:

CimCmdlets Module

Létrehoz egy CIM-munkamenetet.

Syntax

CredentialParameterSet (Alapértelmezett)

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>]

Description

A parancsmag csak a Windows platform.

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 ComputerName, a használt protokollt vagy különböző azonosítókat.

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 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. Alapértelmezés szerint New-CimSession WSMan-munkamenetet hoz létre ComputerName megadásakor.

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 az ComputerNameáltal megadott számítógépekre 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 távoli CIM-munkameneteket hoz létre az ComputerNameáltal megadott számítógépekre a vesszővel elválasztott listában, és barátságos nevet rendel az új munkamenetekhez a Namemegadásával.

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 Get-CimSession.

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épre, a Hitelesítő adatokáltal megadott PSCredential objektummal, valamint a Hitelesítésáltal megadott hitelesítési típussal.

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

A parancsmaggal létrehozhat Get-Credential objektumot.

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épre 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
• Összefoglaló
• Tárgyal
• Alapszintű
• Kerberos
• NtlmDomain
• CredSsp

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

Figyelmezteté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.

Paramétertulajdonságok

Típus:	PasswordAuthenticationMechanism
Alapértelmezett érték:	None
Elfogadott értékek:	Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

CredentialParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	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 PowerShell-tanúsítványszolgáltató Get-Item vagy Get-ChildItem parancsmagjait.

További információért lásd a about_Certificate_Providerrészt.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

CertificateParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	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 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.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Kína, Kiszolgálónév

Paraméterkészletek

(All)

Position:	1
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Credential

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

Adja meg 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"
• Felhasználói fő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.

Paramétertulajdonságok

Típus:	PSCredential
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

CredentialParameterSet

Position:	2
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Name

A CIM-munkamenet barátságos 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.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	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 a OperationTimeoutSec paraméter értéke kisebb, mint a 3 perces robusztus kapcsolat-újrapróbálkozási időtúllépés, a 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őt, mielőtt az ügyfél újracsatlakozhat.

Paramétertulajdonságok

Típus:	UInt32
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	OT

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	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>"}

Ne használja a Port paramétert, hacsak nem szükséges. 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.

Paramétertulajdonságok

Típus:	UInt32
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-SessionOption

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

Paramétertulajdonságok

Típus:	CimSessionOptions
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-SkipTestConnection

A New-CimSession parancsmag alapértelmezés szerint 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 ellenőrizze a megadott fiók hitelesítő adatait. Az ellenőrzés szabványos WS-Identity művelettel történik. Hozzáadhatja a SkipTestConnection[switch] 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.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

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 tartalmazza New-CimSession:

• Windows:
  • ncms

Ez a parancsmag csak Windows platformokon érhető el.

Kapcsolódó hivatkozások

• Get-ChildItem
• Get-Credential
• Get-Item (Elem lekérése)
• Get-CimSession
• Remove-CimSession
• New-CimSessionOption
• CimSession bemutatása