Delen via

New-CimSession

  • Referentie
Module:
CimCmdlets

Hiermee maakt u een CIM-sessie.

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

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 ComputerNaam, 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 Creatie met standaardopties

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

New-CimSession

Voorbeeld 2: een CIM-sessie Creatie naar een specifieke computer

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

New-CimSession -ComputerName Server01

Voorbeeld 3: een CIM-sessie Creatie 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 Creatie 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 Creatie 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 Creatie 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 Creatie 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:

  • Standaard
  • Samenvatting
  • Negotiate
  • Basic
  • 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.

Waarschuwing

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

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

Hiermee geeft u het digitale openbare sleutelcertificaat (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 cmdlets of Get-ChildItem in de PowerShell Certificate Provider.

Zie about_Certificate_Provider voor meer informatie.

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

-ComputerName

Hiermee geeft u de naam van de computer waarop de CIM-sessie te maken. 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 de 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 dan de gebruiker bevindt, moet u de volledig gekwalificeerde domeinnaam opgeven.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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: "Gebruiker01"
  • 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

U kunt de naam gebruiken om naar de CIM-sessie te verwijzen 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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OperationTimeoutSec

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

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

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

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 de verbinding 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 te luisteren op die poort. 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 parameter Poort niet, tenzij u dat 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 op alle computers wordt uitgevoerd.

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

-SessionOption

Hiermee stelt u geavanceerde opties voor de nieuwe CIM-sessie in. 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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SkipTestConnection

Standaard maakt de New-CimSession cmdlet een verbinding met een extern WS-Management-eindpunt om twee redenen: 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 standaardbewerking WS-Identity. U kunt de switchparameter SkipTestConnection toevoegen als het externe WS-Management-eindpunt WS-Identify niet kan gebruiken, of om de tijd voor gegevensoverdracht te verkorten.

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

Invoerwaarden

None

U kunt geen objecten doorsnijden naar deze cmdlet.

Uitvoerwaarden

CimSession

Deze cmdlet retourneert een CIM-sessieobject.

Notities

PowerShell bevat de volgende aliassen voor New-CimSession:

  • Windows:
    • ncms

Deze cmdlet is alleen beschikbaar op Windows-platforms.