Delen via


New-CimSession

Hiermee maakt u een CIM-sessie.

Syntaxis

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

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De New-CimSession cmdlet maakt een CIM-sessie. Een CIM-sessie is een object aan de clientzijde dat een verbinding met een lokale computer of een externe computer vertegenwoordigt. De CIM-sessie bevat informatie over de verbinding, zoals ComputerName, het gebruikte protocol of verschillende id's.

Deze cmdlet retourneert een CIM-sessieobject dat kan worden gebruikt door alle andere CIM-cmdlets.

Voorbeelden

Voorbeeld 1: Een CIM-sessie maken met standaardopties

In dit voorbeeld wordt een lokale CIM-sessie gemaakt met standaardopties. Als ComputerName niet is opgegeven, New-CimSession maakt u een DCOM-sessie op de lokale computer.

New-CimSession

Voorbeeld 2: Een CIM-sessie maken op een specifieke computer

In dit voorbeeld wordt een CIM-sessie gemaakt op de computer die is opgegeven door ComputerName. Maakt standaard New-CimSession een WSMan-sessie wanneer ComputerName is opgegeven.

New-CimSession -ComputerName Server01

Voorbeeld 3: Een CIM-sessie maken op meerdere computers

In dit voorbeeld wordt een CIM-sessie gemaakt voor elk van de computers die zijn opgegeven door ComputerName, in de door komma's gescheiden lijst.

New-CimSession -ComputerName Server01,Server02,Server03

Voorbeeld 4: Een CIM-sessie maken met een beschrijvende naam

In dit voorbeeld wordt een externe CIM-sessie gemaakt voor elk van de computers die zijn opgegeven door ComputerName, in de door komma's gescheiden lijst, en wordt een beschrijvende naam toegewezen aan de nieuwe sessies door Naam op te geven.

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

U kunt de beschrijvende naam van een CIM-sessie gebruiken om te verwijzen naar de sessie in andere CIM-cmdlets, bijvoorbeeld Get-CimSession.

Voorbeeld 5: Een CIM-sessie maken op een computer met behulp van een PSCredential-object

In dit voorbeeld wordt een CIM-sessie gemaakt op de computer die is opgegeven door ComputerName, met behulp van het PSCredential-object dat is opgegeven door referentie en het verificatietype dat is opgegeven door verificatie.

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

U kunt een PSCredential-object maken met behulp van de Get-Credential cmdlet.

Voorbeeld 6: Een CIM-sessie maken op een computer met behulp van een specifieke poort

In dit voorbeeld wordt een CIM-sessie gemaakt op de computer die is opgegeven door ComputerName met behulp van de TCP-poort die is opgegeven door poort.

New-CimSession -ComputerName Server01 -Port 1234

Voorbeeld 7: Een CIM-sessie maken met behulp van DCOM

In dit voorbeeld wordt een CIM-sessie gemaakt met behulp van het DCOM-protocol (Distributed COM) in plaats van WSMan.

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

Parameters

-Authentication

Hiermee geeft u het verificatietype op dat wordt gebruikt voor de referenties van de gebruiker. De aanvaardbare waarden voor deze parameter zijn:

  • Standaardinstelling
  • Verteren
  • Onderhandelen
  • Basis
  • Kerberos
  • NtlmDomain
  • CredSsp

U kunt het verificatietype NtlmDomain niet gebruiken voor verbinding met de lokale computer. CredSSP-verificatie is alleen beschikbaar in Windows Vista, Windows Server 2008 en latere versies van Windows.

Let op

CredSSP-verificatie (Credential Security Service Provider) is ontworpen voor opdrachten waarvoor verificatie is vereist voor meer dan één resource, zoals toegang tot een externe netwerkshare. Dit mechanisme verhoogt het beveiligingsrisico van de externe bewerking. Als de externe computer is aangetast, kunnen de referenties die aan de computer worden doorgegeven, worden gebruikt om de netwerksessie te beheren.

Type:PasswordAuthenticationMechanism
Geaccepteerde waarden:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-CertificateThumbprint

Hiermee geeft u het certificaat van de digitale openbare sleutel (X.509) van een gebruikersaccount dat gemachtigd is om deze actie uit te voeren. Voer de vingerafdruk van het certificaat in.

Certificaten worden gebruikt in verificatie op basis van clientcertificaten. Ze kunnen alleen worden toegewezen aan lokale gebruikersaccounts; ze werken niet met domeinaccounts.

Als u een vingerafdruk van een certificaat wilt ophalen, gebruikt u de Get-Item of Get-ChildItem cmdlets in de PowerShell-certificaatprovider.

Zie about_Certificate_Provider voor meer informatie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u de naam op van de computer waarop de CIM-sessie moet worden gemaakt. Geef één computernaam of meerdere computernamen op, gescheiden door een komma.

Als ComputerName niet is opgegeven, wordt er een CIM-sessie naar de lokale computer gemaakt. U kunt de waarde voor computernaam opgeven in een van de volgende indelingen:

  • Een of meer NetBIOS-namen
  • Een of meer IP-adressen
  • Een of meer volledig gekwalificeerde domeinnamen.

Als de computer zich in een ander domein bevindt dan de gebruiker, moet u de volledig gekwalificeerde domeinnaam opgeven.

Type:String[]
Aliassen:CN, ServerName
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. Als referentie niet is opgegeven, wordt het huidige gebruikersaccount gebruikt.

Geef de waarde voor Referentie op met een van de volgende indelingen:

  • Een gebruikersnaam: 'User01'
  • Een domeinnaam en een gebruikersnaam: "Domain01\User01"
  • Een user principal name: "User@Domain.com"
  • Een PSCredential-object, zoals een object dat wordt geretourneerd door de Get-Credential cmdlet.

Wanneer u een gebruikersnaam typt, wordt u gevraagd om een wachtwoord.

Type:PSCredential
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u een beschrijvende naam voor de CIM-sessie.

U kunt de naam gebruiken om te verwijzen naar de CIM-sessie wanneer u andere cmdlets gebruikt, zoals de Cmdlet Get-CimSession . De naam hoeft niet uniek te zijn voor de computer of de huidige sessie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-OperationTimeoutSec

Duur waarvoor de cmdlet wacht op een reactie van de server.

De waarde van deze parameter is standaard 0, wat betekent dat de cmdlet de standaardtime-outwaarde voor de server gebruikt.

Als de parameter OperationTimeoutSec is ingesteld op een waarde die kleiner is dan de robuuste time-out voor opnieuw proberen van 3 minuten, kunnen netwerkfouten die meer duren dan de waarde van de parameter OperationTimeoutSec niet herstellen, omdat er een time-out optreedt voordat de client opnieuw verbinding kan maken.

Type:UInt32
Aliassen:OT
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Port

Hiermee geeft u de netwerkpoort op de externe computer die wordt gebruikt voor deze verbinding. Als u verbinding wilt maken met een externe computer, moet de externe computer luisteren op de poort die door de verbinding wordt gebruikt. De standaardpoorten zijn 5985 (de WinRM-poort voor HTTP) en 5986 (de WinRM-poort voor HTTPS).

Voordat u een alternatieve poort gebruikt, moet u de WinRM-listener op de externe computer configureren om naar die poort te luisteren. Gebruik de volgende opdrachten om de listener te configureren:

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

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

Gebruik de poortparameter alleen als u dit moet doen. De poortinstelling in de opdracht is van toepassing op alle computers of sessies waarop de opdracht wordt uitgevoerd. Een alternatieve poortinstelling kan verhinderen dat de opdracht wordt uitgevoerd op alle computers.

Type:UInt32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SessionOption

Hiermee stelt u geavanceerde opties in voor de nieuwe CIM-sessie. Voer de naam in van een CimSessionOption-object dat is gemaakt met behulp van de New-CimSessionOption cmdlet.

Type:CimSessionOptions
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SkipTestConnection

De cmdlet brengt standaard New-CimSession om twee redenen een verbinding tot stand met een extern WS-Management-eindpunt: om te controleren of de externe server luistert op het poortnummer dat is opgegeven met behulp van de poortparameter en om de opgegeven accountreferenties te verifiëren. De verificatie wordt uitgevoerd met behulp van een standaard WS-Identity-bewerking. U kunt de parameter SkipTestConnection-switch toevoegen als het externe WS-Management-eindpunt WS-Identify niet kan gebruiken of om bepaalde tijd voor gegevensoverdracht te verminderen.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

CimSession

Met deze cmdlet wordt een CIM-sessieobject geretourneerd.

Notities

PowerShell bevat de volgende aliassen voor New-CimSession:

  • Windows:
    • ncms

Deze cmdlet is alleen beschikbaar op Windows-platforms.