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

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 zur Verbindung, z. B. ComputerName, das für die Verbindung verwendete Protokoll, sitzungs-ID und instance-ID.

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

Beispiele

Beispiel 1: Create einer CIM-Sitzung mit Standardoptionen

New-CimSession

Mit diesem Befehl wird eine lokale CIM-Sitzung mit Standardoptionen erstellt. Wenn ComputerName nicht angegeben ist, New-CimSession erstellt eine DCOM-Sitzung für den lokalen Computer.

Beispiel 2: Create einer CIM-Sitzung auf einen bestimmten Computer

New-CimSession -ComputerName Server01

Mit diesem Befehl wird eine CIM-Sitzung für den durch ComputerName angegebenen Computer erstellt. Erstellt standardmäßig eine WsMan-Sitzung, New-CimSession wenn ComputerName angegeben ist.

Beispiel 3: Create einer CIM-Sitzung auf mehrere Computer

New-CimSession -ComputerName Server01,Server02,Server03

Mit diesem Befehl wird eine CIM-Sitzung für jeden der Computer erstellt, die in der durch Kommas getrennten Liste angegeben sind.

Beispiel 4: Create einer CIM-Sitzung mit einem Anzeigenamen

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

New-CimSession -ComputerName Server01,Server02 -Name FileServers

Get-CimSession -Name File*

Dieser Befehl erstellt eine CIM-Remotesitzung für jeden der computername angegebenen Computer in der durch Kommas getrennten Liste und weist den neuen Sitzungen einen Anzeigenamen zu, indem Name angegeben wird.

Beispiel 5: Create einer CIM-Sitzung auf einen Computer mithilfe eines PSCredential-Objekts

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

Mit diesem Befehl wird eine CIM-Sitzung für den computerspezifischen Computer erstellt, wobei das durch Credential angegebene PSCredential-Objekt und der durch Authentication angegebene Authentifizierungstyp verwendet wird.

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

Beispiel 6: Create einer CIM-Sitzung auf einen Computer mithilfe eines bestimmten Ports

New-CimSession -ComputerName Server01 -Port 1234

Mit diesem Befehl wird eine CIM-Sitzung für den von ComputerName angegebenen Computer mithilfe des TCP-Ports erstellt, der durch Port angegeben wird.

Beispiel 7: Create einer CIM-Sitzung mithilfe von DCOM

$SessionOption = New-CimSessionOption -Protocol DCOM

New-CimSession -ComputerName Server1 -SessionOption $SessionOption

Mit diesem Befehl wird eine CIM-Sitzung erstellt, indem anstelle von WSMan das DCOM-Protokoll (Distributed COM) verwendet wird.

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
  • Basic
  • Kerberos
  • NtlmDomain
  • Credssp

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

Vorsicht: Die CredSSP (Credential Security Service Provider)-Authentifizierung, bei der die Anmeldeinformationen des Benutzers zur Authentifizierung an einen Remotecomputer übergeben werden, ist für Befehle konzipiert, die die Authentifizierung auf mehr als einer Ressource erfordern, z. B. beim 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.

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

-CertificateThumbprint

Gibt das Zertifikat für digitale öffentliche 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 oder Get-ChildItem im PowerShell-Zertifikatanbieter. Weitere Informationen zur Verwendung des PowerShell-Zertifikatanbieters finden Sie Get-Help Certificateunter Zertifikatanbieter.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 für den lokalen Computer erstellt.

Sie können den Wert für den Computernamen in einem der folgenden Formate angeben:

  • Mindestens ein NetBIOS-Name
  • Eine oder mehrere IP-Adressen
  • 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.

Sie können mithilfe der Pipeline auch einen Computernamen (in Anführungszeichen) an New-CimSession übergeben.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 mit einem der folgenden Formate an:

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

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

Type:PSCredential
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Get-CimSession Cmdlet. Der Name muss für den Computer oder die aktuelle Sitzung nicht eindeutig sein.

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

-OperationTimeoutSec

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

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

Wenn der Parameter OperationTimeoutSec auf einen Wert festgelegt ist, der kleiner als das stabile Timeout der Verbindungswiederherstellungsversuche von 3 Minuten ist, sind Netzwerkfehler, die länger als der Wert des Parameters OperationTimeoutSec dauern, nicht wiederherstellbar, da für den Vorgang auf dem Server ein Timeout auftritt, bevor der Client die Verbindung wiederherstellen kann.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 nur, wenn es unbedingt notwendig ist. 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.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:CimSessionOptions
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 an der Portnummer lauscht, die mithilfe des Port-Parameters angegeben wird, und um die angegebenen Kontoanmeldeinformationen zu überprüfen. Die Überprüfung erfolgt mithilfe eines Standardvorgangs WS-Identity. Sie können den SkipTestConnection-Switchparameter hinzufügen, wenn der Remote-WS-Management-Endpunkt WS-Identify nicht verwenden kann oder wenn Sie die Datenübertragungszeit verkürzen möchten.

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

Eingaben

None

Dieses Cmdlet akzeptiert keine Eingaben.

Ausgaben

CimSession