Sdílet prostřednictvím

New-CimSessionOption

  • Reference
Modul:
CimCmdlets

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

Syntaxe

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

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina New-CimSessionOption vytvoří instanci objektu možností relace CIM. Objekt možností relace CIM použijete jako vstup do New-CimSession rutiny 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 modelu DCOM, nebo vrátí možnosti relace WsMan.

Příklady

Příklad 1: Vytvoření objektu možností relace CIM pro model 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á rutině New-CimSession . New-CimSession pak vytvoří novou relaci CIM se vzdáleným serverem s názvem Server01 pomocí možností definovaných v proměnné.

$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í 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.

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

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

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

Tento příklad 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á jazyková verze 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ů:

  • Název jazykové verze ve <languagecode2>-<country/regioncode2> formátu, například EN-US.
  • Proměnná, která obsahuje CultureInfo objekt.
  • Příkaz, který získá objekt CultureInfo , například Get-Culture
Typ:CultureInfo
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-EncodePortInServicePrincipalName

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Encoding

Určuje kódování použité pro protokol WsMan. Přijatelné hodnoty pro tento parametr jsou: Default, Utf8 nebo Utf16.

Typ:PacketEncoding
Přípustné hodnoty:Default, Utf8, Utf16
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-HttpPrefix

Určuje část adresy URL PROTOKOLU HTTP za názvem počítače a číslem portu. Změna není běžná. Ve výchozím nastavení je hodnota tohoto parametru /wsman.

Typ:Uri
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Impersonation

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

Platné hodnoty pro tento parametr jsou:

  • Výchozí hodnota: Model DCOM může zvolit úroveň zosobnění pomocí svého normálního algoritmu 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.
  • Zosobnění: 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í, New-CimSession použije rutina hodnotu zosobnění.

Typ:ImpersonationType
Přípustné hodnoty:Default, None, Identify, Impersonate, Delegate
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxEnvelopeSizeKB

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

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NoEncryption

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PacketIntegrity

Určuje, že relace modelu DCOM vytvořená pro rozhraní 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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PacketPrivacy

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Protocol

Určuje protokol, který se má použít. Přijatelné hodnoty pro tento parametr jsou: DCOM, Default nebo Wsman.

Typ:ProtocolType
Přípustné hodnoty:Dcom, Default, Wsman
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ProxyAuthentication

Určuje metodu ověřování, která se má použít pro překlad proxy serveru. Přijatelné hodnoty pro tento parametr jsou: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain nebo CredSsp.

Typ:PasswordAuthenticationMechanism
Přípustné hodnoty:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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 Get-Item Get-ChildItem rutiny v jednotce PowerShell Cert:

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Výchozí hodnota tohoto parametru je InternetExplorer.

Typ:ProxyType
Přípustné hodnoty:None, WinHttp, Auto, InternetExplorer
Position:Named
Default value:InternetExplorer
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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 <languagecode2>-<country/regioncode2> formátu, například EN-US.
  • Proměnná, která obsahuje CultureInfo objekt.
  • Příkaz, který získá CultureInfo objekt, například Get-Culture.
Typ:CultureInfo
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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ý.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

None

Do této rutiny nemůžete roušit 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

Tato rutina je dostupná jenom na platformách Windows.