New-CimSessionOption

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

Description

Exempel

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

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

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

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

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

New-CimSessionOption -Culture fr-FR -Protocol Wsman

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:

• Ett kulturnamn i <languagecode2>-<country/regioncode2> format som "en-US".
• En variabel som innehåller ett CultureInfo- objekt.
• Ett kommando som hämtar ett CultureInfo--objekt, till exempel Get-Culture

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-Encoding

Anger den kodning som används för WsMan-protokollet. De godtagbara värdena för den här parametern är: Standard, Utf8eller Utf16.

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-Impersonation

Skapar en DCOM-session till Windows Management Instrumentation (WMI) med hjälp av användarinlevelse.

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 inloggningsuppgifter.
• Ombud: Tillåter att objekt tillåter att andra objekt använder anroparens autentiseringsuppgifter.

Om Personifiering inte har angetts, använder cmdleten New-CimSession värdet av Personifiera.

Parameteregenskaper

Parameteruppsättningar

-MaxEnvelopeSizeKB

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

Parameteregenskaper

Parameteruppsättningar

-NoEncryption

Anger att datakryptering är inaktiverat.

Parameteregenskaper

Parameteruppsättningar

-PacketIntegrity

Anger att den DCOM-session som skapats till WMI använder funktionaliteten i Component Object Model (COM) PacketIntegrity. Som standard har alla CIM-sessioner som skapats med DCOM parametern PacketIntegrity inställd på True.

Parameteregenskaper

Parameteruppsättningar

-PacketPrivacy

Skapar en DCOM-session till WMI med COM PacketPrivacy. Som standard har alla CIM-sessioner som skapats med DCOM parametern PacketPrivacy inställd på true.

Parameteregenskaper

Parameteruppsättningar

-Protocol

Anger vilket protokoll som ska användas. De godtagbara värdena för den här parametern är: Dcom, Standardeller Wsman.

Parameteregenskaper

Parameteruppsättningar

-ProxyAuthentication

Anger den autentiseringsmetod som ska användas för proxymatchning. De godtagbara värdena för den här parametern är: Standard, Digest, Negotiate, Basic, Kerberos, NtlmDomaineller CredSsp.

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-ProxyType

Anger vilken lösningsmekanism för värdnamn som ska användas. De godtagbara värdena för den här parametern är: None, WinHttp, Autoeller InternetExplorer.

Standardvärdet för den här parametern är InternetExplorer.

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-SkipCNCheck

Anger att certifikatets gemensamma namn (CN) på servern inte behöver matcha serverns värdnamn. Använd den här parametern endast för fjärråtgärder med betrodda datorer som använder HTTPS-protokollet.

Parameteregenskaper

Parameteruppsättningar

-SkipRevocationCheck

Anger att återkallningskontrollen för servercertifikat utlämnas. Använd endast den här parametern för betrodda datorer.

Parameteregenskaper

Parameteruppsättningar

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

• Ett kulturnamn i <languagecode2>-<country/regioncode2> format som "en-US".
• En variabel som innehåller ett CultureInfo-objekt.
• Ett kommando som hämtar ett CultureInfo-objekt, till exempel Get-Culture.

Parameteregenskaper

Parameteruppsättningar

-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, även när du använder HTTP.

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.

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

None

Utdata

CimSessionOptions

Kommentarer

Relaterade länkar

• Get-ChildItem
• Get-Credential
• Get-Culture
• Hämta objekt
• Ny-CimSession