New-CimSessionOption
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
Den här cmdleten är endast tillgänglig på Windows-plattformen.
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
Det här exemplet 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 .
$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so
Exempel 2: Skapa ett CIM-sessionsalternativobjekt för WsMan
I det här exemplet skapas 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.
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl
Exempel 3: Skapa ett CIM-sessionsalternativobjekt med den angivna kulturen
New-CimSessionOption -Culture Fr-Fr -Protocol Wsman
Det här exemplet 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:
- 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
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Encoding
Anger den kodning som används för WsMan-protokollet. Godkända värden för den här parametern är: Standard, Utf8 eller Utf16.
Type: | PacketEncoding |
Accepted values: | Default, Utf8, Utf16 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HttpPrefix
Anger delen 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.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Impersonation
Skapar en DCOM-session till Windows Management Instrumentation (WMI) med hjälp av 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 att objekt frågar efter anroparens autentiseringsuppgifter.
- Personifiera: Tillåter att objekt använder anroparens autentiseringsuppgifter.
- Ombud: Tillåter objekt att tillåta andra objekt att använda anroparens autentiseringsuppgifter.
Om personifiering inte anges New-CimSession
använder cmdleten värdet Personifiera.
Type: | ImpersonationType |
Accepted values: | Default, None, Identify, Impersonate, Delegate |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxEnvelopeSizeKB
Anger storleksgränsen för WsMan XML-meddelanden för endera riktningen.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoEncryption
Anger att datakryptering är inaktiverat.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PacketIntegrity
Anger att DCOM-sessionen som skapats för WMI använder funktionen PacketIntegrity för komponentobjektmodellen (COM). Som standard har alla CIM-sessioner som skapats med DCOM parametern PacketIntegrity angett till True.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PacketPrivacy
Skapar en DCOM-session till WMI med COM PacketPrivacy. Som standard har alla CIM-sessioner som skapats med DCOM parametern PacketPrivacy angett till true.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Protocol
Anger vilket protokoll som ska användas. De godkända värdena för den här parametern är: DCOM, Default eller Wsman.
Type: | ProtocolType |
Accepted values: | Dcom, Default, Wsman |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyAuthentication
Anger den autentiseringsmetod som ska användas för proxymatchning. Acceptabla värden för den här parametern är: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain eller CredSsp.
Type: | PasswordAuthenticationMechanism |
Accepted values: | Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 certifikatet Get-Item
använder du cmdletarna eller Get-ChildItem
i PowerShell Cert:-enheten.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyType
Anger vilken mekanism för värdnamnsmatchning som ska användas. De godkända värdena för den här parametern är: None, WinHttp, Auto eller InternetExplorer.
Standardvärdet för den här parametern är InternetExplorer.
Type: | ProxyType |
Accepted values: | None, WinHttp, Auto, InternetExplorer |
Position: | Named |
Default value: | InternetExplorer |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkipCACheck
Anger att klienten inte verifierar att servercertifikatet har signerats av en betrodd certifikatutfärdare (CA) när den ansluter via HTTPS.
Använd bara 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkipCNCheck
Anger att certifikatets eget 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkipRevocationCheck
Anger att återkallningskontrollen för servercertifikat hoppas över. Använd endast den här parametern för betrodda datorer.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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:
- 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
.
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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, ä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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.