New-CimSessionOption
Gibt erweiterte Optionen für das Cmdlet New-CimSession an.
Syntax
New-CimSessionOption
[-Protocol] <ProtocolType>
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>] 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>] New-CimSessionOption
[-Impersonation <ImpersonationType>]
[-PacketIntegrity]
[-PacketPrivacy]
[-UICulture <CultureInfo>]
[-Culture <CultureInfo>]
[<CommonParameters>] Beschreibung
Das Cmdlet New-CimSessionOption erstellt eine instance 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: einen für WsMan-Optionen und einen für DCOM-Optionen (Distributed Component Object Model). Je nachdem, welche Parameter Sie verwenden, gibt das Cmdlet entweder eine instance der DCOM-Sitzungsoptionen oder WsMan-Sitzungsoptionen zurück.
Beispiele
Beispiel 1: Create eines CIM-Sitzungsoptionenobjekts für DCOM
$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $soDieser 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 mit dem Namen Server01, wobei die in der Variablen definierten Optionen verwendet werden.
Beispiel 2: Create eines CIM-Sitzungsoptionenobjekts für WsMan
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSslDieser Befehl erstellt ein CIM-Sitzungsoptionenobjekt für das WsMan-Protokoll. Das -Objekt enthält die Konfiguration für den vom ProxyAuthentication-Parameter angegebenen Kerberos-Authentifizierungsmodus, die durch den ProxyCredential-Parameter angegebenen Anmeldeinformationen und gibt an, dass der Befehl die Zertifizierungsstellenprüfung überspringen, die CN-Überprüfung überspringen und SSL verwenden soll.
Beispiel 3: Create eines CIM-Sitzungsoptionenobjekts mit der angegebenen Kultur
New-CimSessionOption -Culture Fr-Fr -Protocol WsmanDieser 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 mithilfe des Culture-Parameters ü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 im <languagecode2>-<country/regioncode2> Format "EN-US" ein.
Eine Variable, die ein CultureInfo-Objekt enthält.
Ein Befehl, der ein CultureInfo-Objekt abruft, z. B. Get-Culture
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EncodePortInServicePrincipalName
Gibt an, dass die Kerberos-Verbindung eine Verbindung mit einem Dienst herstellt, dessen Dienstprinzipalname (SPN) die Dienstportnummer enthält. Diese Art von Verbindung ist nicht üblich.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | PacketEncoding |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HttpPrefix
Gibt den Teil der HTTP-URL nach dem Computernamen und der Portnummer an. Dies zu ändern ist nicht üblich.
Standardmäßig ist der Wert dieses Parameters /wsman.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Impersonation
Erstellt mithilfe des Identitätswechsels eine DCOM-Sitzung für die Windows-Verwaltungsinstrumentation (WMI).
Gültige Parameterwerte:
- Standard: DCOM kann die Identitätswechselebene mithilfe des normalen Sicherheitsverhandlungsalgorithmus auswählen.
- Keine: Der Client ist für den Server anonym. Der Serverprozess kann die Identität des Clients annehmen, aber das Identitätswechseltoken enthält keine Informationen und kann nicht verwendet werden.
- Identifizieren: Ermöglicht Objekten das Abfragen der Anmeldeinformationen des Aufrufers.
- Identitätswechsel: Ermöglicht Objekten die Verwendung der Anmeldeinformationen des Aufrufers.
- Delegat: Ermöglicht es Objekten, anderen Objekten die Verwendung der Anmeldeinformationen des Aufrufers zu gestatten.
Wenn Identitätswechsel nicht angegeben ist, verwendet das Cmdlet New-CimSession den Wert von 3: Identitätswechsel.
| Type: | ImpersonationType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxEnvelopeSizeKB
Gibt die Größenbeschränkung von WsMan-XML-Nachrichten für beide Richtungen an.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NoEncryption
Gibt an, dass die Datenverschlüsselung deaktiviert ist.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PacketIntegrity
Gibt an, dass die für WMI erstellte DCOM-Sitzung die PacketIntegrity-Funktionalität des Com-Objekts (Component Object Model) verwendet. Zur Erhöhung der Sicherheit ist für alle CIM-Sitzungen, die mit DCOM erstellt wurden, der Parameter PacketIntegrity auf True festgelegt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PacketPrivacy
Erstellt eine DCOM-Sitzung für WMI mithilfe von COM PacketPrivacy. Zur Erhöhung der Sicherheit ist für alle CIM-Sitzungen, die mit DCOM erstellt wurden, der Parameter PacketPrivacy auf true festgelegt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
Gibt das zu verwendende Protokoll an.
Die zulässigen Werte für diesen Parameter sind: DCOM oder WinRM.
| Type: | ProtocolType |
| Accepted values: | Dcom, Default, Wsman |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | PasswordAuthenticationMechanism |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCertificateThumbprint
Gibt das (x.509) digitale Öffentliche Schlüsselzertifikat eines Benutzerkontos für die Proxyauthentifizierung an. 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-Laufwerk Cert: .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
Gibt die Anmeldeinformationen an, die für die Proxyauthentifizierung verwendet werden sollen. Geben Sie eine der folgenden Informationen an:
- 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.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProxyType
Gibt den zu verwendenden Mechanismus für die Hostnamenauflösung an.
Die zulässigen Werte für diesen Parameter sind: None, WinHttp, Auto oder InternetExplorer.
Standardmäßig ist der Wert dieses Parameters InternetExplorer.
| Type: | ProxyType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 mithilfe eines anderen Mechanismus vertrauenswürdig ist, z. B. wenn der Remotecomputer Teil eines physisch sicheren und isolierten Netzwerks ist oder wenn der Remotecomputer in einer WinRM-Konfiguration als vertrauenswürdiger Host aufgeführt wird.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipCNCheck
Gibt an, dass der allgemeine Zertifikatname (Certificate Common Name, 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SkipRevocationCheck
Gibt an, dass die Sperrprüfung für Serverzertifikate übersprungen wird.
Hinweis: Verwenden Sie diesen Parameter nur für vertrauenswürdige Computer.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 im
<languagecode2>-<country/regioncode2>Format "EN-US" ein. - Eine Variable, die ein CultureInfo-Objekt enthält.
- Ein Befehl, der ein CultureInfo-Objekt abruft, z
Get-Culture. B. .
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Eingaben
None
Dieses Cmdlet akzeptiert keine Eingabeobjekte.
Ausgaben
CIMSessionOption
Dieses Cmdlet gibt ein -Objekt zurück, das INFORMATIONEN zu CIM-Sitzungsoptionen enthält.