New-CimSession

Syntax

CredentialParameterSet (Standard)

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

Beschreibung

Beispiele

Beispiel 1: Erstellen einer CIM-Sitzung mit Standardoptionen

New-CimSession

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

New-CimSession -ComputerName Server01

Beispiel 3: Erstellen einer CIM-Sitzung auf mehreren Computern

New-CimSession -ComputerName Server01,Server02,Server03

Beispiel 4: Erstellen einer CIM-Sitzung mit einem freundlichen Namen

New-CimSession -ComputerName Server01,Server02 -Name FileServers

Get-CimSession -Name File*

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

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

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

New-CimSession -ComputerName Server01 -Port 1234

Beispiel 7: Erstellen einer CIM-Sitzung mit DCOM

$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. Die zulässigen Werte für diesen Parameter sind:

• Standard
• Zusammenfassung
• Verhandeln
• Basic
• 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 Dienstanbieters für Anmeldeinformationen (Credential Security Service Provider, CredSSP), bei der die Anmeldeinformationen des Benutzers an einen Remotecomputer übergeben werden, der authentifiziert werden soll, ist für Befehle vorgesehen, die eine Authentifizierung für mehrere Ressourcen erfordern, z. B. den Zugriff auf eine Remotenetzwerkfreigabe. Dieser Mechanismus erhöht das Sicherheitsrisiko des Remotevorgangs. Wenn der Remotecomputer kompromittiert ist, können die an ihn übergebenen Anmeldeinformationen zum Steuern der Netzwerksitzung verwendet werden.

Parametereigenschaften

Parametersätze

-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 in der zertifikatbasierten Clientauthentifizierung verwendet. Sie können nur lokalen Benutzerkonten zugeordnet werden; sie funktionieren nicht mit Domänenkonten.

Verwenden Sie zum Abrufen eines Zertifikatfingerabdrucks die Cmdlets Get-Item oder Get-ChildItem im PowerShell-Zertifikatanbieter. Weitere Informationen zur Verwendung des PowerShell-Zertifikatanbieters, geben Sie Get-Help Certificateein, oder lesen Sie Zertifikatanbieter.

Parametereigenschaften

Parametersätze

-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 zum 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
• Einer oder mehrere vollqualifizierte Domänennamen.

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

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

Parametereigenschaften

Parametersätze

-Credential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Wenn Anmeldeinformation nicht angegeben ist, wird das aktuelle Benutzerkonto verwendet.

Geben Sie den Wert für Anmeldeinformations- mithilfe eines 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 vom Cmdlet Get-Credential zurückgegeben wird.

Wenn Sie einen Benutzernamen eingeben, werden Sie aufgefordert, ein Kennwort einzugeben.

Parametereigenschaften

Parametersätze

-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 nicht für den Computer oder die aktuelle Sitzung eindeutig sein.

Parametereigenschaften

Parametersätze

-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 OperationTimeoutSec-Parameter auf einen Wert festgelegt ist, der kleiner als das robuste Verbindungswiederholungszeitlimit von 3 Minuten ist, können Netzwerkfehler, die länger als den Wert des OperationTimeoutSec-Parameters dauern, nicht wiederhergestellt werden, da der Vorgang auf dem Server überschritten wird, bevor der Client die Verbindung erneut herstellen kann.

Parametereigenschaften

Parametersätze

-Port

Gibt den Netzwerkport auf dem Remotecomputer an, der für diese Verbindung verwendet wird. 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 Sie einen alternativen Port verwenden, müssen Sie den WinRM-Listener auf dem Remotecomputer so konfigurieren, dass er an diesem Port lauscht. 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 nicht den Parameter Port, es sei denn, Sie müssen. Die Porteinstellung im Befehl gilt für alle Computer oder Sitzungen, auf denen der Befehl ausgeführt wird. Eine alternative Porteinstellung kann verhindern, dass der Befehl auf allen Computern ausgeführt wird.

Parametereigenschaften

Parametersätze

-SessionOption

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

Parametereigenschaften

Parametersätze

-SkipTestConnection

Standardmäßig stellt das cmdlet New-CimSession 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 parameters Port angegeben wird, 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 wenn Sie einige Datenübertragungszeiten reduzieren möchten.

Parametereigenschaften

Parametersätze

CommonParameters

Eingaben

None

Ausgaben

CimSession

Ähnliche Themen

• Get-ChildItem
• Get-Credential
• Get-Item
• Get-CimSession
• Remove-CimSession
• New-CimSessionOption
• Über CimSession