New-CimSessionOption

Modul:

CimCmdlets Module

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

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das New-CimSessionOption Cmdlet erstellt eine Instanz eines CIM-Sitzungsoptionenobjekts. Sie verwenden ein CIM-Sitzungsoptionenobjekt als Eingabe für das New-CimSession Cmdlet, 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

In diesem Beispiel wird ein CIM-Sitzungsoptionenobjekt für das DCOM-Protokoll erstellt und in einer Variablen mit dem Namen $sogespeichert. Der Inhalt der Variablen wird dann an das New-CimSession Cmdlet übergeben. New-CimSession erstellt dann eine neue CIM-Sitzung mit dem Remoteserver "Server01", wobei die in der Variablen definierten Optionen verwendet werden.

$so = New-CimSessionOption -Protocol Dcom
New-CimSession -ComputerName Server01 -SessionOption $so

Beispiel 2: Erstellen eines CIM-Sitzungsoptionenobjekts für WsMan

In diesem Beispiel 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.

$option = @{
    ProxyAuthentication = 'Kerberos'
    ProxyCredential = $cred
    SkipCACheck = $true
    SkipCNCheck = $true
    UseSsl = $true
}
New-CimSessionOption @option

Beispiel 3: Erstellen eines CIM-Sitzungsoptionenobjekts mit der angegebenen Kultur

New-CimSessionOption -Culture fr-FR -Protocol Wsman

In diesem Beispiel wird die Kultur angegeben, 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:

• Ein Kulturname im <languagecode2>-<country/regioncode2> Format "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
Zulässige Werte:	Default, Utf8, Utf16
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. Das Ändern ist 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 eine DCOM-Sitzung zum Windows Management Instrumentation (WMI) mithilfe des Identitätswechsels.

Der Parameter PasswordQuality gibt die Mindestbewertung für die Qualität von Kennwörtern an, die für Gerätekennwörter erforderlich ist. Kennwortqualität ist eine numerische Skala, die die Sicherheit und die Komplexität des Kennworts angibt. Ein höherer Qualitätswert signalisiert ein sichereres Kennwort.

• Standard: DCOM kann die Identitätswechselstufe mithilfe des normalen Sicherheitsverhandlungsalgorithmus 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.
• Identitätswechsel: Ermöglicht es Objekten, die Anmeldeinformationen des Aufrufers zu verwenden.
• Delegat: Ermöglicht Objekten die Verwendung der Anmeldeinformationen des Aufrufers für andere Objekte.

Wenn der Identitätswechsel nicht angegeben ist, verwendet das New-CimSession Cmdlet den Wert des Identitätswechsels.

Parametereigenschaften

Typ:	ImpersonationType
Standardwert:	None
Zulässige Werte:	Default, None, Identify, Impersonate, Delegate
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. Standardmäßig haben 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. Standardmäßig haben 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, Default oder Wsman.

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
Zulässige Werte:	Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
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 Get-Item Cmdlets 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.

Der Standardwert dieses Parameters ist InternetExplorer.

Parametereigenschaften

Typ:	ProxyType
Standardwert:	InternetExplorer
Zulässige Werte:	None, WinHttp, Auto, InternetExplorer
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 mit vertrauenswürdigen Computern, auf denen das HTTPS-Protokoll verwendet 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

-SkipRevocationCheck

Gibt an, dass die Sperrüberprüfung für Serverzertifikate übersprungen wird. 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:

• Ein Kulturname im <languagecode2>-<country/regioncode2> Format "en-US".
• Eine Variable, die ein CultureInfo-Objekt enthält.
• Ein Befehl, der ein CultureInfo-Objekt abruft, z Get-Culture. B. .

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, auch wenn HTTP verwendet wird.

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

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

CimSessionOptions

Dieses Cmdlet gibt ein Objekt zurück, das Informationen zu CIM-Sitzungsoptionen enthält.

Hinweise

PowerShell enthält die folgenden Aliase für New-CimSessionOption:

• Fenster:
  • ncso

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.

Ähnliche Themen

• Get-ChildItem
• Get-Credential
• Get-Culture
• Get-Item
• New-CimSession