New-CimSessionOption

Modul:: CimCmdlets Module

Určuje upřesňující možnosti pro rutinu New-CimSession.

Syntax

ProtocolTypeSet (Výchozí)

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

Description

Rutina New-CimSessionOption vytvoří instanci objektu možností relace CIM. Objekt možností relace CIM použijete jako vstup do rutiny New-CimSession k určení možností relace CIM.

Tato rutina má dvě sady parametrů, jednu pro možnosti WsMan a jednu pro možnosti modelu DCOM (Distributed Component Object Model). V závislosti na tom, které parametry použijete, vrátí rutina buď instanci možností relace DCOM nebo možnosti relace WsMan.

Příklady

Příklad 1: Vytvoření objektu možností relace CIM pro DCOM

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

Tato sada příkazů vytvoří objekt možností relace CIM pro protokol DCOM a uloží ho do proměnné s názvem $so. Obsah proměnné se pak předá rutině New-CimSession. New-CimSession pak pomocí možností definovaných v proměnné vytvoří novou relaci CIM se vzdáleným serverem s názvem Server01.

Příklad 2: Vytvoření objektu možností relace CIM pro WsMan

New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl

Tento příkaz vytvoří objekt možností relace CIM pro protokol WsMan. Objekt obsahuje konfiguraci pro režim ověřování protokolu Kerberos určený parametrem ProxyAuthentication, přihlašovací údaje zadané parametrem ProxyCredential a určuje, že příkaz přeskočí kontrolu certifikační autority, přeskočí kontrolu CN a použije SSL.

Příklad 3: Vytvoření objektu možností relace CIM se zadanou kulturou

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

Tento příkaz určuje jazykovou verzi, která se používá pro relaci CIM. Ve výchozím nastavení se při provádění operací používá kultura klienta. Výchozí jazykovou verzi je však možné přepsat pomocí parametru Culture.

Parametry

-Culture

Určuje jazykovou verzi uživatelského rozhraní, která se má použít pro relaci CIM. Zadejte hodnotu tohoto parametru pomocí jednoho z následujících formátů:

Zadejte název jazykové verze ve formátu <languagecode2>-<country/regioncode2>, například EN-US.

Proměnná, která obsahuje CultureInfo objekt.

Příkaz, který získá objekt CultureInfo, například Get-Culture

Vlastnosti parametru

Typ:	CultureInfo
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-EncodePortInServicePrincipalName

Označuje, že připojení Kerberos se připojuje ke službě, jejíž hlavní identifikátor služby (SPN) obsahuje číslo portu služby. Tento typ připojení není běžný.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

WSManParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Encoding

Určuje kódování použité pro protokol WsMan.

Přijatelné hodnoty pro tento parametr jsou: Default, Utf8 nebo Utf16.

Vlastnosti parametru

Typ:	PacketEncoding
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

WSManParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-HttpPrefix

Určuje část adresy URL PROTOKOLU HTTP za názvem počítače a číslem portu. Změnit to není obvyklé.

Ve výchozím nastavení je hodnota tohoto parametru /wsman.

Vlastnosti parametru

Typ:	Uri
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

WSManParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Impersonation

Vytvoří relaci DCOM s rozhraním WMI (Windows Management Instrumentation) pomocí zosobnění.

Platné hodnoty pro tento parametr jsou:

Výchozí hodnota: DCOM může zvolit úroveň zosobnění pomocí svého obvyklého algoritmu pro vyjednávání zabezpečení.
Žádné: Klient je pro server anonymní. Proces serveru může zosobnit klienta, ale token zosobnění neobsahuje žádné informace a nelze ho použít.
Identifikace: Umožňuje objektům dotazovat přihlašovací údaje volajícího.
Impersonace: Umožňuje objektům používat přihlašovací údaje volajícího.
Delegát: Umožňuje objektům povolit jiným objektům používat přihlašovací údaje volajícího.

Pokud není zadaná zosobnění, použije rutina New-CimSession hodnotu 3: Zosobnit

Vlastnosti parametru

Typ:	ImpersonationType
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

DcomParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MaxEnvelopeSizeKB

Určuje limit velikosti zpráv XML wsMan pro oba směry.

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

WSManParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-NoEncryption

Určuje, že šifrování dat je vypnuté.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

WSManParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PacketIntegrity

Určuje, že relace modelu DCOM vytvořená pro rozhraní WMI používá funkci PacketIntegrity modelu COM (Component Object Model). U rozšířeného zabezpečení mají ve výchozím nastavení všechny relace CIM vytvořené pomocí modelu DCOM parametr PacketIntegrity nastaven na hodnotu True.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

DcomParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PacketPrivacy

Vytvoří relaci modelu DCOM pro rozhraní WMI pomocí atributu COM PacketPrivacy. Pro lepší zabezpečení mají ve výchozím nastavení všechny relace CIM vytvořené pomocí modelu DCOM parametr PacketPrivacy nastaven na hodnotu true.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

DcomParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Protocol

Určuje protokol, který se má použít.

Přijatelné hodnoty pro tento parametr jsou: DCOM nebo WinRM.

Vlastnosti parametru

Typ:	ProtocolType
Default value:	None
Přípustné hodnoty:	Dcom, Default, Wsman
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ProtocolTypeSet

Position:	1
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ProxyAuthentication

Určuje metodu ověřování, která se má použít pro určení proxy serveru.

Přijatelné hodnoty pro tento parametr jsou: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain nebo CredSsp.

Vlastnosti parametru

Typ:	PasswordAuthenticationMechanism
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

WSManParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ProxyCertificateThumbprint

Určuje certifikát digitálního veřejného klíče (x.509) uživatelského účtu pro ověřování proxy serverem. Zadejte kryptografický otisk certifikátu.

Certifikáty se používají při ověřování na základě klientských certifikátů. Dají se namapovat jenom na místní uživatelské účty a nefungují s doménovými účty.

Pokud chcete získat kryptografický otisk certifikátu, použijte rutiny Get-Item nebo Get-ChildItem v jednotce PowerShell Cert:

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

WSManParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ProxyCredential

Určuje přihlašovací údaje, které se mají použít pro ověřování proxy serveru. Zadejte jednu z následujících možností:

Proměnná, která obsahuje objekt PSCredential.
Příkaz, který získá objekt PSCredential, například Get-Credential

Pokud tato možnost není nastavená, nemůžete zadat žádné přihlašovací údaje.

Vlastnosti parametru

Typ:	PSCredential
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

WSManParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ProxyType

Určuje mechanismus překladu názvů hostitelů, který se má použít.

Přijatelné hodnoty pro tento parametr jsou: None, WinHttp, Auto nebo InternetExplorer.

Ve výchozím nastavení je hodnota tohoto parametru InternetExplorer.

Vlastnosti parametru

Typ:	ProxyType
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

WSManParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-SkipCACheck

Označuje, že při připojování přes PROTOKOL HTTPS klient neověřuje, že certifikát serveru je podepsaný důvěryhodnou certifikační autoritou (CA).

Tento parametr použijte pouze v případě, že je vzdálený počítač důvěryhodný pomocí jiného mechanismu, například pokud je vzdálený počítač součástí sítě, která je fyzicky zabezpečená a izolovaná, nebo pokud je vzdálený počítač uveden jako důvěryhodný hostitel v konfiguraci WinRM.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

WSManParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-SkipCNCheck

Označuje, že běžný název certifikátu (CN) serveru nemusí odpovídat názvu hostitele serveru.

Tento parametr použijte pouze pro vzdálené operace, které používají protokol HTTPS.

Poznámka: Tento parametr použijte pouze pro důvěryhodné počítače.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

WSManParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-SkipRevocationCheck

Označuje, že kontrola odvolání certifikátů serveru se přeskočí.

Poznámka: Tento parametr použijte pouze pro důvěryhodné počítače.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

WSManParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-UICulture

Určuje jazykovou verzi uživatelského rozhraní, která se má použít pro relaci CIM. Zadejte hodnotu tohoto parametru pomocí jednoho z následujících formátů:

Zadejte název jazykové verze ve formátu <languagecode2>-<country/regioncode2>, například EN-US.
Proměnná, která obsahuje CultureInfo objekt.
Příkaz, který získá objekt "CultureInfo", jako například Get-Culture.

Vlastnosti parametru

Typ:	CultureInfo
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-UseSsl

Označuje, že protokol SSL by se měl použít k navázání připojení ke vzdálenému počítači. Ve výchozím nastavení se ssl nepoužívá.

WsMan šifruje veškerý obsah přenášený přes síť. Tento parametr umožňuje zadat další ochranu HTTPS místo PROTOKOLU HTTP. Pokud protokol SSL není k dispozici na portu použitém pro připojení a zadáte tento parametr, příkaz selže.

Tento parametr doporučujeme použít pouze v případě, že parametr PacketPrivacy není zadaný.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

WSManParameterSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Sdílet prostřednictvím

New-CimSessionOption

Syntax

ProtocolTypeSet (Výchozí)

WSManParameterSet

DcomParameterSet

Description

Příklady

Příklad 1: Vytvoření objektu možností relace CIM pro DCOM

Příklad 2: Vytvoření objektu možností relace CIM pro WsMan

Příklad 3: Vytvoření objektu možností relace CIM se zadanou kulturou

Parametry

-Culture

Vlastnosti parametru

Sady parametrů

-EncodePortInServicePrincipalName

Vlastnosti parametru

Sady parametrů

-Encoding

Vlastnosti parametru

Sady parametrů

-HttpPrefix

Vlastnosti parametru

Sady parametrů

-Impersonation

Vlastnosti parametru

Sady parametrů

-MaxEnvelopeSizeKB

Vlastnosti parametru

Sady parametrů

-NoEncryption

Vlastnosti parametru

Sady parametrů

-PacketIntegrity

Vlastnosti parametru

Sady parametrů

-PacketPrivacy

Vlastnosti parametru

Sady parametrů

-Protocol

Vlastnosti parametru

Sady parametrů

-ProxyAuthentication

Vlastnosti parametru

Sady parametrů

-ProxyCertificateThumbprint

Vlastnosti parametru

Sady parametrů

-ProxyCredential

Vlastnosti parametru

Sady parametrů

-ProxyType

Vlastnosti parametru

Sady parametrů

-SkipCACheck

Vlastnosti parametru

Sady parametrů

-SkipCNCheck

Vlastnosti parametru

Sady parametrů

-SkipRevocationCheck

Vlastnosti parametru

Sady parametrů

-UICulture

Vlastnosti parametru

Sady parametrů

-UseSsl

Vlastnosti parametru

Sady parametrů

CommonParameters

Vstupy

None

Výstupy

CIMSessionOption

Související odkazy