Freigeben über

New-CimSession

  • Referenz
Modul:
CimCmdlets

Erstellt eine CIM-Sitzung.

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

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das New-CimSession Cmdlet erstellt eine CIM-Sitzung. Eine CIM-Sitzung ist ein clientseitiges Objekt, das eine Verbindung mit einem lokalen Computer oder einem Remotecomputer darstellt. Die CIM-Sitzung enthält Informationen über die Verbindung, z . B. ComputerName, das verwendete Protokoll oder verschiedene Bezeichner.

Dieses Cmdlet gibt ein CIM-Sitzungsobjekt zurück, das von allen anderen CIM-Cmdlets verwendet werden kann.

Beispiele

Beispiel 1: Erstellen einer CIM-Sitzung mit Standardoptionen

In diesem Beispiel wird eine lokale CIM-Sitzung mit Standardoptionen erstellt. Wenn ComputerName nicht angegeben ist, New-CimSession wird eine DCOM-Sitzung auf dem lokalen Computer erstellt.

New-CimSession

Beispiel 2: Erstellen einer CIM-Sitzung auf einem bestimmten Computer

In diesem Beispiel wird eine CIM-Sitzung auf dem computerspezifischen ComputerName erstellt. Erstellt standardmäßig eine WSMan-Sitzung, New-CimSession wenn ComputerName angegeben wird.

New-CimSession -ComputerName Server01

Beispiel 3: Erstellen einer CIM-Sitzung auf mehreren Computern

In diesem Beispiel wird eine CIM-Sitzung für jeden computer erstellt, der durch ComputerName in der durch Kommas getrennten Liste angegeben wird.

New-CimSession -ComputerName Server01,Server02,Server03

Beispiel 4: Erstellen einer CIM-Sitzung mit einem Anzeigenamen

In diesem Beispiel wird eine Cim-Remotesitzung für jeden computer erstellt, der durch ComputerName angegeben wird, in der durch Trennzeichen getrennten Liste und weist den neuen Sitzungen einen Anzeigenamen zu, indem Name angegeben wird.

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

Sie können den Anzeigenamen einer CIM-Sitzung verwenden, um auf die Sitzung in anderen CIM-Cmdlets zu verweisen, z. B. Get-CimSession.

Beispiel 5: Erstellen einer CIM-Sitzung auf einem Computer mithilfe eines PSCredential-Objekts

In diesem Beispiel wird eine CIM-Sitzung auf dem Computer erstellt, der von ComputerName angegeben wird, wobei das durch Anmeldeinformationen angegebene PSCredential-Objekt und der durch die Authentifizierung angegebene Authentifizierungstyp verwendet werden.

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

Sie können ein PSCredential-Objekt mithilfe des Get-Credential Cmdlets erstellen.

Beispiel 6: Erstellen einer CIM-Sitzung auf einem Computer mithilfe eines bestimmten Ports

In diesem Beispiel wird eine CIM-Sitzung auf dem Computer erstellt, der von ComputerName mithilfe des durch Port angegebenen TCP-Ports angegeben wird.

New-CimSession -ComputerName Server01 -Port 1234

Beispiel 7: Erstellen einer CIM-Sitzung mit DCOM

In diesem Beispiel wird anstelle von WSMan eine CIM-Sitzung mit dem DCOM-Protokoll (Distributed COM) erstellt.

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

Parameter

-Authentication

Gibt den Authentifizierungstyp an, der für die Anmeldeinformationen des Benutzers verwendet wird. Zulässige Werte für diesen Parameter:

  • Standard
  • Digest
  • Aushandeln
  • Grundlegend
  • Kerberos
  • NtlmDomain
  • CredSsp

Sie können den NtlmDomain-Authentifizierungstyp nicht für die Verbindung mit dem lokalen Computer verwenden. CredSSP-Authentifizierung ist nur in Windows Vista, Windows Server 2008 und höheren Versionen von Windows verfügbar.

Achtung

Die Authentifizierung des Credential Security Service Provider (CredSSP) wurde für Befehle entwickelt, die eine Authentifizierung für mehrere Ressourcen erfordern, z. B. den Zugriff auf eine Remotenetzwerkfreigabe. Dieser Mechanismus erhöht das Sicherheitsrisiko des Remotevorgangs. Wenn die Sicherheit des Remotecomputers gefährdet ist, können die an ihn übergebenen Anmeldeinformationen zum Steuern der Netzwerksitzung verwendet werden.

Typ:PasswordAuthenticationMechanism
Zulässige Werte:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-CertificateThumbprint

Gibt das Zertifikat für den digitalen öffentlichen Schlüssel (X.509) eines Benutzerkontos an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Geben Sie den Zertifikatfingerabdruck des Zertifikats ein.

Zertifikate werden bei der clientzertifikatbasierten Authentifizierung verwendet. Sie können nur lokalen Benutzerkonten zugeordnet werden und funktionieren nicht mit Domänenkonten.

Verwenden Sie zum Abrufen eines Zertifikatfingerabdrucks die Get-Item Cmdlets Get-ChildItem im PowerShell-Zertifikatanbieter.

Weitere Informationen finden Sie unter about_Certificate_Provider.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ComputerName

Gibt den Namen des Computers an, auf dem die CIM-Sitzung erstellt werden soll. Geben Sie entweder einen einzelnen Computernamen oder mehrere Computernamen an, die durch ein Komma getrennt sind.

Wenn ComputerName nicht angegeben ist, wird eine CIM-Sitzung auf dem lokalen Computer erstellt. Sie können den Wert für den Computernamen in einem der folgenden Formate angeben:

  • Mindestens ein NetBIOS-Name
  • Mindestens eine IP-Adresse:
  • Mindestens ein vollqualifizierter Domänenname.

Wenn sich der Computer in einer anderen Domäne als der Benutzer befindet, müssen Sie den vollqualifizierten Domänennamen angeben.

Typ:String[]
Aliase:CN, ServerName
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Credential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Wenn keine Anmeldeinformationen angegeben sind, wird das aktuelle Benutzerkonto verwendet.

Geben Sie den Wert für Anmeldeinformationen in einem der folgenden Formate an:

  • Ein Benutzername: "User01"
  • Ein Domänenname und ein Benutzername: "Domain01\User01"
  • Ein Benutzerprinzipalname: "User@Domain.com"
  • Ein PSCredential-Objekt, z. B. ein objekt, das Get-Credential vom Cmdlet zurückgegeben wird.

Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.

Typ:PSCredential
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen Anzeigenamen für die CIM-Sitzung an.

Sie können den Namen verwenden, um auf die CIM-Sitzung zu verweisen, wenn Sie andere Cmdlets verwenden, z. B. das Cmdlet Get-CimSession . Der Name muss für den Computer oder die aktuelle Sitzung nicht eindeutig sein.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OperationTimeoutSec

Dauer, für die das Cmdlet auf eine Antwort vom Server wartet.

Standardmäßig ist der Wert dieses Parameters 0, was bedeutet, dass das Cmdlet den Standardtimeoutwert für den Server verwendet.

Wenn der Parameter OperationTimeoutSec auf einen Wert festgelegt ist, der kleiner als das robuste Verbindungsretrytimeout von 3 Minuten ist, können Netzwerkfehler, die mehr als der Wert des OperationTimeoutSec-Parameters dauern, nicht wiederhergestellt werden, da der Vorgang auf dem Server zu einem Timeout vor dem erneuten Herstellen der Verbindung führen kann.

Typ:UInt32
Aliase:OT
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Port

Gibt den Netzwerkport an dem für diese Verbindung verwendeten Remotecomputer an. Zum Herstellen einer Verbindung mit einem Remotecomputer muss der Remotecomputer den für die Verbindung verwendeten Port abhören. Die Standardports sind 5985 (der WinRM-Port für HTTP) und 5986 (der WinRM-Port für HTTPS).

Bevor ein alternativer Port verwendet werden kann, müssen Sie den WinRM-Listener auf dem Remotecomputer für das Abhören an diesen Port konfigurieren. Verwenden Sie die folgenden Befehle, um den Listener zu konfigurieren:

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

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

Verwenden Sie den Port-Parameter nicht, es sei denn, Sie müssen. Die Porteinstellung im Befehl gilt für alle Computer oder Sitzungen, für die der Befehl ausgeführt wird. Eine alternative Porteinstellung kann verhindern, dass der Befehl auf allen Computern ausgeführt wird.

Typ:UInt32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SessionOption

Legt erweiterte Optionen für die neue CIM-Sitzung fest. Geben Sie den Namen eines CimSessionOption-Objekts ein, das mit dem New-CimSessionOption Cmdlet erstellt wurde.

Typ:CimSessionOptions
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SkipTestConnection

Standardmäßig stellt das New-CimSession Cmdlet eine Verbindung mit einem Remote-WS-Management-Endpunkt aus zwei Gründen her: um zu überprüfen, ob der Remoteserver die Portnummer überwacht, die mithilfe des Portparameters angegeben ist, und um die angegebenen Kontoanmeldeinformationen zu überprüfen. Die Überprüfung erfolgt mithilfe eines standardmäßigen WS-Identity-Vorgangs. Sie können den Parameter "SkipTestConnection switch" hinzufügen, wenn der Remote-WS-Management-Endpunkt WS-Identify nicht verwenden kann oder um die Datenübertragungszeit zu verringern.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

CimSession

Dieses Cmdlet gibt ein CIM-Sitzungsobjekt zurück.

Hinweise

PowerShell enthält die folgenden Aliase für New-CimSession:

  • Windows:
    • ncms

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.