New-CimSessionOption
Gibt erweiterte Optionen für das Cmdlet New-CimSession an.
Syntax
ProtocolTypeSet (Standard)
New-CimSessionOption
[-Protocol] <ProtocolType>
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>]
WSManParameterSet
New-CimSessionOption
[-NoEncryption]
[-SkipCACheck]
[-SkipCNCheck]
[-SkipRevocationCheck]
[-EncodePortInServicePrincipalName]
[-Encoding <PacketEncoding>]
[-HttpPrefix <Uri>]
[-MaxEnvelopeSizeKB <UInt32>]
[-ProxyAuthentication <PasswordAuthenticationMechanism>]
[-ProxyCertificateThumbprint <String>]
[-ProxyCredential <PSCredential>]
[-ProxyType <ProxyType>]
[-UseSsl]
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>]
DcomParameterSet
New-CimSessionOption
[-Impersonation <ImpersonationType>]
[-PacketIntegrity]
[-PacketPrivacy]
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>]
Beschreibung
Das Cmdlet New-CimSessionOption erstellt eine Instanz eines CIM-Sitzungsoptionenobjekts. Sie verwenden ein CIM-Sitzungsoptionenobjekt als Eingabe für das Cmdlet New-CimSession, um die Optionen für eine CIM-Sitzung anzugeben.
Dieses Cmdlet verfügt über zwei Parametersätze, eine für WsMan-Optionen und eine für DCOM-Optionen (Distributed Component Object Model). Je nachdem, welche Parameter Sie verwenden, gibt das Cmdlet entweder eine Instanz von DCOM-Sitzungsoptionen zurück oder gibt WsMan-Sitzungsoptionen zurück.
Beispiele
Beispiel 1: Erstellen eines CIM-Sitzungsoptionenobjekts für DCOM
$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so
Dieser Satz von Befehlen erstellt ein CIM-Sitzungsoptionenobjekt für das DCOM-Protokoll und speichert es in einer Variablen namens $so. Der Inhalt der Variablen wird dann an das Cmdlet New-CimSession übergeben. New-CimSession erstellt dann eine neue CIM-Sitzung mit dem Remoteserver "Server01", wobei die in der Variablen definierten Optionen verwendet werden.
Beispiel 2: Erstellen eines CIM-Sitzungsoptionenobjekts für WsMan
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl
Mit diesem Befehl wird ein CIM-Sitzungsoptionenobjekt für das WsMan-Protokoll erstellt. Das Objekt enthält die Konfiguration für den Authentifizierungsmodus von Kerberos, der durch den Parameter ProxyAuthentication, die durch den Parameter ProxyCredential angegebenen Anmeldeinformationen angegeben ist, und gibt an, dass der Befehl die Zertifizierungsstelle-Überprüfung überspringen, die CN-Prüfung überspringen und SSL verwenden soll.
Beispiel 3: Erstellen eines CIM-Sitzungsoptionenobjekts mit der angegebenen Kultur
New-CimSessionOption -Culture Fr-Fr -Protocol Wsman
Dieser Befehl gibt die Kultur an, die für die CIM-Sitzung verwendet wird. Standardmäßig wird die Kultur des Clients beim Ausführen von Vorgängen verwendet. Die Standardkultur kann jedoch mit dem Parameter "Culture" überschrieben werden.
Parameter
-Culture
Gibt die Benutzeroberflächenkultur an, die für die CIM-Sitzung verwendet werden soll. Geben Sie den Wert für diesen Parameter in einem der folgenden Formate an:
Geben Sie einen Kulturnamen in <languagecode2>-<country/regioncode2> Format ein, z. B. "EN-US".
Eine Variable, die ein CultureInfo-Objekt enthält.
Ein Befehl, der ein CultureInfo-Objekt abruft, z. B. Get-Culture
Parametereigenschaften
| Typ: | CultureInfo |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-EncodePortInServicePrincipalName
Gibt an, dass die Kerberos-Verbindung eine Verbindung mit einem Dienst herstellt, dessen Dienstprinzipalname (SPN) die Dienstportnummer enthält. Dieser Verbindungstyp ist nicht üblich.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
WSManParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Encoding
Gibt die für das WsMan-Protokoll verwendete Codierung an.
Die zulässigen Werte für diesen Parameter sind: Default, Utf8 oder Utf16.
Parametereigenschaften
| Typ: | PacketEncoding |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
WSManParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-HttpPrefix
Gibt den Teil der HTTP-URL nach dem Computernamen und der Portnummer an. Änderungen sind nicht üblich.
Standardmäßig ist der Wert dieses Parameters "/wsman".
Parametereigenschaften
| Typ: | Uri |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
WSManParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Impersonation
Erstellt per Identitätswechsel eine DCOM-Sitzung mit der Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI).
Gültige Werte für diesen Parameter sind:
- Standard: DCOM kann die Impersonationsstufe mithilfe seines normalen Sicherheitsaushandlungsalgorithmus auswählen.
- Keine: Der Client ist anonym für den Server. Der Serverprozess kann den Client imitieren, aber das Identitätswechseltoken enthält keine Informationen und kann nicht verwendet werden.
- Identifizieren: Ermöglicht Objekten das Abfragen der Anmeldeinformationen des Aufrufers.
- Impersonate: Ermöglicht es Objekten, die Anmeldeinformationen des Aufrufers zu verwenden.
- Delegieren: Ermöglicht es Objekten, anderen Objekten die Nutzung der Anmeldeinformationen des Aufrufers zu gestatten.
Wenn der Identitätswechsel nicht angegeben ist, verwendet das cmdlet New-CimSession den Wert 3: Identitätswechsel
Parametereigenschaften
| Typ: | ImpersonationType |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
DcomParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MaxEnvelopeSizeKB
Gibt die Größenbeschränkung von WsMan-XML-Nachrichten für beide Richtungen an.
Parametereigenschaften
| Typ: | UInt32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
WSManParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-NoEncryption
Gibt an, dass die Datenverschlüsselung deaktiviert ist.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
WSManParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PacketIntegrity
Gibt an, dass die für WMI erstellte DCOM-Sitzung die PacketIntegrity-Funktionalität (Component Object Model, COM) verwendet. Für erhöhte Sicherheit haben standardmäßig alle mit DCOM erstellten CIM-Sitzungen den Parameter PacketIntegrity auf "True" festgelegt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
DcomParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PacketPrivacy
Erstellt eine DCOM-Sitzung mit WMI mithilfe der COM PacketPrivacy. Für erhöhte Sicherheit haben standardmäßig alle mit DCOM erstellten CIM-Sitzungen den Parameter "PacketPrivacy" auf "true" festgelegt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
DcomParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Protocol
Gibt das zu verwendende Protokoll an.
Die zulässigen Werte für diesen Parameter sind: DCOM oder WinRM.
Parametereigenschaften
| Typ: | ProtocolType |
| Standardwert: | None |
| Zulässige Werte: | Dcom, Default, Wsman |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ProtocolTypeSet
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ProxyAuthentication
Gibt die Authentifizierungsmethode an, die für die Proxyauflösung verwendet werden soll.
Die zulässigen Werte für diesen Parameter sind: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain oder CredSsp.
Parametereigenschaften
| Typ: | PasswordAuthenticationMechanism |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
WSManParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ProxyCertificateThumbprint
Gibt das (x.509)-Zertifikat für den digitalen öffentlichen Schlüssel eines Benutzerkontos für die Proxyauthentifizierung an. Geben Sie den Zertifikatfingerabdruck des Zertifikats ein.
Zertifikate werden in der zertifikatbasierten Clientauthentifizierung verwendet. Sie können nur lokalen Benutzerkonten zugeordnet werden und funktionieren nicht mit Domänenkonten.
Verwenden Sie zum Abrufen eines Zertifikatfingerabdrucks die Cmdlets Get-Item oder Get-ChildItem im PowerShell-Laufwerk „Cert:“.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
WSManParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ProxyCredential
Gibt die Anmeldeinformationen an, die für die Proxyauthentifizierung verwendet werden sollen. Geben Sie eine der folgenden Optionen ein:
- Eine Variable, die ein PSCredential-Objekt enthält.
- Ein Befehl, der ein PSCredential-Objekt abruft, z. B. Get-Credential
Wenn diese Option nicht festgelegt ist, können Sie keine Anmeldeinformationen angeben.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
WSManParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ProxyType
Gibt den zu verwendenden Hostnamenauflösungsmechanismus an.
Die zulässigen Werte für diesen Parameter sind: None, WinHttp, Auto oder InternetExplorer.
Standardmäßig ist der Wert dieses Parameters InternetExplorer.
Parametereigenschaften
| Typ: | ProxyType |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
WSManParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-SkipCACheck
Gibt an, dass der Client beim Herstellen einer Verbindung über HTTPS nicht überprüft, ob das Serverzertifikat von einer vertrauenswürdigen Zertifizierungsstelle signiert ist.
Verwenden Sie diesen Parameter nur, wenn der Remotecomputer mit einem anderen Mechanismus vertrauenswürdig ist, z. B. wenn der Remotecomputer Teil eines netzwerks ist, das physisch sicher und isoliert ist oder wenn der Remotecomputer in einer WinRM-Konfiguration als vertrauenswürdiger Host aufgeführt wird.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
WSManParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-SkipCNCheck
Gibt an, dass der gemeinsame Zertifikatname (CN) des Servers nicht mit dem Hostnamen des Servers übereinstimmen muss.
Verwenden Sie diesen Parameter nur für Remotevorgänge, die das HTTPS-Protokoll verwenden.
Hinweis: Verwenden Sie diesen Parameter nur für vertrauenswürdige Computer.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
WSManParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-SkipRevocationCheck
Gibt an, dass die Sperrüberprüfung für Serverzertifikate übersprungen wird.
Hinweis: Verwenden Sie diesen Parameter nur für vertrauenswürdige Computer.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
WSManParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-UICulture
Gibt die Benutzeroberflächenkultur an, die für die CIM-Sitzung verwendet werden soll. Geben Sie den Wert für diesen Parameter in einem der folgenden Formate an:
- Geben Sie einen Kulturnamen in
<languagecode2>-<country/regioncode2>Format ein, z. B. "EN-US". - Eine Variable, die ein CultureInfo-Objekt enthält.
- Ein Befehl, der ein CultureInfo-Objekt abruft, z. B.
Get-Culture
Parametereigenschaften
| Typ: | CultureInfo |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-UseSsl
Gibt an, dass SSL verwendet werden soll, um eine Verbindung mit dem Remotecomputer herzustellen. Standardmäßig wird SSL nicht verwendet.
WsMan verschlüsselt alle Inhalte, die über das Netzwerk übertragen werden. Mit diesem Parameter können Sie den zusätzlichen Schutz von HTTPS anstelle von HTTP angeben. Wenn SSL für den für die Verbindung verwendeten Port nicht verfügbar ist und Sie diesen Parameter angeben, schlägt der Befehl fehl.
Es wird empfohlen, diesen Parameter nur zu verwenden, wenn der Parameter "PacketPrivacy" nicht angegeben ist.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
WSManParameterSet
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
None
Dieses Cmdlet akzeptiert keine Eingabeobjekte.
Ausgaben
CIMSessionOption
Dieses Cmdlet gibt ein Objekt zurück, das Informationen zu CIM-Sitzungsoptionen enthält.