Dela via

New-CimSessionOption

  • Referens
Modul:
CimCmdlets

Anger avancerade alternativ för cmdleten New-CimSession.

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

Description

Cmdleten New-CimSessionOption skapar en instans av ett CIM-sessionsalternativobjekt. Du använder ett CIM-sessionsalternativobjekt som indata till cmdleten New-CimSession för att ange alternativen för en CIM-session.

Den här cmdleten har två parameteruppsättningar, en för WsMan-alternativ och en för DCOM-alternativ (Distributed Component Object Model). Beroende på vilka parametrar du använder returnerar cmdleten antingen en instans av DCOM-sessionsalternativ eller returnerar WsMan-sessionsalternativ.

Exempel

Exempel 1: Skapa ett CIM-sessionsalternativobjekt för DCOM

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

Den här uppsättningen kommandon skapar ett CIM-sessionsalternativobjekt för DCOM-protokollet och lagrar det i en variabel med namnet $so. Innehållet i variabeln skickas sedan till cmdleten New-CimSession. New-CimSession skapar sedan en ny CIM-session med fjärrservern med namnet Server01, med hjälp av de alternativ som definierats i variabeln.

Exempel 2: Skapa ett CIM-sessionsalternativobjekt för WsMan

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

Det här kommandot skapar ett CIM-sessionsalternativobjekt för WsMan-protokollet. Objektet innehåller konfiguration för autentiseringsläget för Kerberos som anges av parametern ProxyAuthentication, de autentiseringsuppgifter som anges av parametern ProxyCredential och anger att kommandot är att hoppa över CA-kontrollen, hoppa över CN-kontrollen och använda SSL.

Exempel 3: Skapa ett CIM-sessionsalternativobjekt med den angivna kulturen

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

Det här kommandot anger den kultur som används för CIM-sessionen. Som standard används kulturen för klienten när du utför åtgärder. Standardkulturen kan dock åsidosättas med hjälp av parametern Kultur.

Parametrar

-Culture

Anger vilken användargränssnittskultur som ska användas för CIM-sessionen. Ange värdet för den här parametern med något av följande format:

Ange ett kulturnamn i <languagecode2>-<country/regioncode2> format, till exempel "EN-US".

En variabel som innehåller ett CultureInfo-objekt.

Ett kommando som hämtar ett CultureInfo--objekt, till exempel Get-Culture

Typ:CultureInfo
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-EncodePortInServicePrincipalName

Anger att Kerberos-anslutningen ansluter till en tjänst vars tjänsthuvudnamn (SPN) innehåller tjänstens portnummer. Den här typen av anslutning är inte vanlig.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Encoding

Anger den kodning som används för WsMan-protokollet.

De godtagbara värdena för den här parametern är: Standard, Utf8 eller Utf16.

Typ:PacketEncoding
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-HttpPrefix

Anger den del av HTTP-URL:en efter datornamnet och portnumret. Det är inte vanligt att ändra detta.

Som standard är värdet för den här parametern /wsman.

Typ:Uri
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Impersonation

Skapar en DCOM-session till Windows Management Instrumentation (WMI) med personifiering.

Giltiga värden för den här parametern är:

  • Standard: DCOM kan välja personifieringsnivå med hjälp av sin normala algoritm för säkerhetsförhandling.
  • Ingen: Klienten är anonym för servern. Serverprocessen kan personifiera klienten, men personifieringstoken innehåller ingen information och kan inte användas.
  • Identifiera: Tillåter objekt att köra frågor mot anroparens autentiseringsuppgifter.
  • Personifiera: Tillåter att objekt använder anroparens autentiseringsuppgifter.
  • Ombud: Tillåter att objekt tillåter att andra objekt använder anroparens autentiseringsuppgifter.

Om personifiering inte har angetts använder New-CimSession-cmdleten värdet 3: Personifiera

Typ:ImpersonationType
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaxEnvelopeSizeKB

Anger storleksgränsen för WsMan XML-meddelanden för båda riktningarna.

Typ:UInt32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NoEncryption

Anger att datakryptering är inaktiverat.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PacketIntegrity

Anger att DCOM-sessionen som skapades till WMI använder funktionen Komponentobjektmodell (COM) PacketIntegrity. För förbättrad säkerhet har alla CIM-sessioner som skapats med DCOM som standard parametern PacketIntegrity inställd på Sant.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PacketPrivacy

Skapar en DCOM-session till WMI med COM PacketPrivacy. För förbättrad säkerhet har som standard alla CIM-sessioner som skapats med DCOM parametern PacketPrivacy inställt på true.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Protocol

Anger vilket protokoll som ska användas.

De acceptabla värdena för den här parametern är: DCOM eller WinRM.

Typ:ProtocolType
Godkända värden:Dcom, Default, Wsman
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ProxyAuthentication

Anger den autentiseringsmetod som ska användas för proxymatchning.

De acceptabla värdena för den här parametern är: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain eller CredSsp.

Typ:PasswordAuthenticationMechanism
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ProxyCertificateThumbprint

Anger (x.509) certifikatet för den digitala offentliga nyckeln för ett användarkonto för proxyautentisering. Ange certifikatets tumavtryck.

Certifikat används i klientcertifikatbaserad autentisering. De kan bara mappas till lokala användarkonton och de fungerar inte med domänkonton.

Om du vill hämta ett tumavtryck för certifikat använder du cmdletarna Get-Item eller Get-ChildItem i PowerShell Cert: -enheten.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ProxyCredential

Anger de autentiseringsuppgifter som ska användas för proxyautentisering. Ange något av följande:

  • En variabel som innehåller ett PSCredential-objekt.
  • Ett kommando som hämtar ett PSCredential-objekt, till exempel Get-Credential

Om det här alternativet inte har angetts kan du inte ange några autentiseringsuppgifter.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ProxyType

Anger vilken lösningsmekanism för värdnamn som ska användas.

De acceptabla värdena för den här parametern är: None, WinHttp, Auto eller InternetExplorer.

Som standard är värdet för den här parametern InternetExplorer.

Typ:ProxyType
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SkipCACheck

Anger att när du ansluter via HTTPS verifierar klienten inte att servercertifikatet har signerats av en betrodd certifikatutfärdare (CA).

Använd endast den här parametern när fjärrdatorn är betrodd med hjälp av en annan mekanism, till exempel när fjärrdatorn är en del av ett nätverk som är fysiskt säkert och isolerat, eller när fjärrdatorn anges som en betrodd värd i en WinRM-konfiguration.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SkipCNCheck

Anger att certifikatets gemensamma namn (CN) på servern inte behöver matcha serverns värdnamn.

Använd endast den här parametern för fjärråtgärder som använder HTTPS-protokollet.

Obs! Använd endast den här parametern för betrodda datorer.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SkipRevocationCheck

Anger att återkallningskontrollen för servercertifikat hoppas över.

Obs! Använd endast den här parametern för betrodda datorer.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-UICulture

Anger vilken användargränssnittskultur som ska användas för CIM-sessionen. Ange värdet för den här parametern med något av följande format:

  • Ange ett kulturnamn i <languagecode2>-<country/regioncode2> format, till exempel "EN-US".
  • En variabel som innehåller ett CultureInfo-objekt.
  • Ett kommando som hämtar ett CultureInfo-objekt, till exempel Get-Culture.
Typ:CultureInfo
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-UseSsl

Anger att SSL ska användas för att upprätta en anslutning till fjärrdatorn. Som standard används inte SSL.

WsMan krypterar allt innehåll som överförs via nätverket. Med den här parametern kan du ange ytterligare skydd för HTTPS i stället för HTTP. Om SSL inte är tillgängligt på den port som används för anslutningen och du anger den här parametern misslyckas kommandot.

Vi rekommenderar att du endast använder den här parametern när parametern PacketPrivacy inte har angetts.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

None

Den här cmdleten accepterar inga indataobjekt.

Utdata

CIMSessionOption

Den här cmdleten returnerar ett objekt som innehåller information om CIM-sessionsalternativ.