New-CimSession
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 ü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 wird, 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 New-CimSession
eine WSMan-Sitzung, 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 jede von ComputerName angegebene Computersitzung in der getrennten Kommaliste erstellt.
New-CimSession -ComputerName Server01,Server02,Server03
Beispiel 4: Erstellen einer CIM-Sitzung mit einem Anzeigenamen
In diesem Beispiel wird eine Remote-CIM-Sitzung für jede der Computer erstellt, die von ComputerName angegeben werden, in der durch Komma getrennten Liste, und weist einen Anzeigenamen für die neuen Sitzungen zu, indem Sie Name angeben.
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 vonComputerName angegeben wird, indem das PSCredential-Objekt verwendet wird, das von Credential angegeben ist, und den von der Authentifizierung angegebenen Authentifizierungstyp.
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 angegeben wird, indem der TCP-Port von Port angegeben wird.
New-CimSession -ComputerName Server01 -Port 1234
Beispiel 7: Erstellen einer CIM-Sitzung mithilfe von DCOM
In diesem Beispiel wird eine CIM-Sitzung mit dem Distributed COM (DCOM)-Protokoll anstelle von WSMan 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
- Standard
- 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 späteren Versionen von Windows verfügbar.
Achtung
Die Credential Security Service Provider (CredSSP)-Authentifizierung ist für Befehle konzipiert, die eine Authentifizierung für mehrere Ressourcen erfordern, z. B. 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 |
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
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 die Get-Item
Get-ChildItem
Cmdlets im PowerShell-Zertifikatanbieter, um einen Zertifikatabdruck abzurufen.
Weitere Informationen finden Sie unter about_Certificate_Provider.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
Gibt den Namen des Computers an, an 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 wird, wird eine CIM-Sitzung auf dem lokalen Computer erstellt. Sie können den Wert für den Computernamen in einem der folgenden Formate angeben:
- Ein oder mehrere NetBIOS-Namen
- Mindestens eine IP-Adresse
- Eine oder mehrere vollqualifizierte Domänennamen.
Wenn sich der Computer in einer anderen Domäne befindet als der Benutzer, müssen Sie den vollqualifizierten Domänennamen angeben.
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 Anmeldeinformationen nicht angegeben werden, 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: "Domäne01\User01"
- Ein Benutzerprinzipalname: "User@Domain.com"
- Ein PSCredential-Objekt, z. B. ein vom
Get-Credential
Cmdlet zurückgegebenes Objekt.
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, was bedeutet, dass das Cmdlet den Standardzeitoutwert für den Server verwendet.
Wenn der Parameter "OperationTimeoutSec " auf einen Wert festgelegt ist, der kleiner als das robuste Verbindungs-Timeout von 3 Minuten ist, können Netzwerkfehler, die mehr als den Wert des OperationTimeoutSec-Parameters dauern, nicht wiederhergestellt werden, da der Vorgang auf dem Server nicht wieder hergestellt werden kann, bevor der Client eine Verbindung herstellen 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 mithilfe des New-CimSessionOption
Cmdlets 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 die Portnummer überwacht, die mithilfe des Portparameters angegeben wird, und um die angegebenen Kontoanmeldeinformationen zu überprüfen. Die Überprüfung erfolgt mithilfe eines Standard-WS-Identity-Vorgangs. Sie können den Parameter SkipTestConnection hinzufügen, wenn der Remote-WS-Management-Endpunkt WS-Identifizieren nicht verwenden kann oder um einige Datenübertragungszeit zu reduzieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Eingaben
None
Dieses Cmdlet akzeptiert keine Eingaben.