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

Tato rutina je dostupná jenom na platformě Windows.

Cmdlet New-CimSessionOption vytvoří instanci objektu s možnostmi 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

Tento příklad 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á cmdletu 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.

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

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

Tento příklad vytvoří objekt možností relace CIM pro protokol WsMan. Objekt obsahuje konfiguraci pro režim ověřování 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.

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

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

New-CimSessionOption -Culture fr-FR -Protocol Wsman

Tento příklad určuje kulturu, 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í kulturu 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ů:

• Název jazykové verze ve formátu <languagecode2>-<country/regioncode2>, například "en-US".
• Proměnná, která obsahuje objekt CultureInfo.
• 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: Výchozí, Utf8nebo Utf16.

Vlastnosti parametru

Typ:	PacketEncoding
Default value:	None
Přípustné hodnoty:	Default, Utf8, Utf16
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í zadáno zosobnění , rutina New-CimSession použije hodnotu 'Zosobnit' .

Vlastnosti parametru

Typ:	ImpersonationType
Default value:	None
Přípustné hodnoty:	Default, None, Identify, Impersonate, Delegate
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 DCOM vytvořená pro WMI používá funkci PacketIntegrity modelu COM (Component Object Model). Ve výchozím nastavení mají 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 DCOM k WMI pomocí COM s PacketPrivacy. Ve výchozím nastavení mají všechny relace CIM vytvořené pomocí modelu DCOM parametr PacketPrivacy nastavený na 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, Default, nebo Wsman.

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: Výchozí, Digest, Negotiate, Základní, Kerberos, NtlmDomainnebo CredSsp.

Vlastnosti parametru

Typ:	PasswordAuthenticationMechanism
Default value:	None
Přípustné hodnoty:	Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
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, Autonebo InternetExplorer.

Výchozí hodnota tohoto parametru je InternetExplorer.

Vlastnosti parametru

Typ:	ProxyType
Default value:	InternetExplorer
Přípustné hodnoty:	None, WinHttp, Auto, InternetExplorer
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 s důvěryhodnými počítači, které používají protokol HTTPS.

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čí. 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ů:

• 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íť i při použití protokolu HTTP.

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.

Vstupy

None

Do tohoto cmdletu nemůžete předávat objekty.

Výstupy

CimSessionOptions

Tato rutina vrátí objekt, který obsahuje informace o možnostech relace CIM.

Poznámky

PowerShell obsahuje následující aliasy pro New-CimSessionOption:

• Windows:
  • ncso

Tento cmdlet je dostupný pouze na platformách Windows.

Související odkazy

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