New-CimSessionOption
A New-CimSession parancsmag speciális beállításait adja meg.
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
Ez a parancsmag csak a Windows platformon érhető el.
A New-CimSessionOption
parancsmag létrehoz egy CIM-munkamenet-beállításobjektum egy példányát. A CIM-munkamenet beállításainak megadásához New-CimSession
a parancsmag bemeneteként egy CIM-munkamenet beállítási objektumát használja.
Ez a parancsmag két paraméterkészlettel rendelkezik, egyet a WsMan beállításaihoz, egyet pedig az elosztott összetevő-objektummodell (DCOM) beállításaihoz. A használt paraméterektől függően a parancsmag a DCOM-munkamenet beállításainak egy példányát adja vissza, vagy a WsMan-munkamenet beállításait adja vissza.
Példák
1. példa: CIM-munkamenet-beállításobjektum létrehozása a DCOM-hoz
Ez a példa létrehoz egy CIM-munkamenet-beállításobjektumot a DCOM protokollhoz, és egy névvel ellátott $so
változóban tárolja. Ezután a rendszer átadja a változó tartalmát a New-CimSession
parancsmagnak.
New-CimSession
ezután létrehoz egy új CIM-munkamenetet a Server01 nevű távoli kiszolgálóval a változóban meghatározott beállítások használatával.
$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so
2. példa: CIM-munkamenet-beállításobjektum létrehozása a WsManhez
Ez a példa létrehoz egy CIM-munkamenet-beállításobjektumot a WsMan protokollhoz. Az objektum a ProxyAuthentication paraméter által megadott Kerberos hitelesítési módjának konfigurációját, a ProxyCredential paraméter által megadott hitelesítő adatokat tartalmazza, és megadja, hogy a parancs a hitelesítésszolgáltató ellenőrzésének kihagyása, a CN-ellenőrzés kihagyása és az SSL használata.
New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl
3. példa: CIM-munkamenetbeállítások objektum létrehozása a megadott kultúrával
New-CimSessionOption -Culture Fr-Fr -Protocol Wsman
Ez a példa a CIM-munkamenethez használt kultúrát határozza meg. Alapértelmezés szerint az ügyfél kultúrája a műveletek végrehajtásakor használatos. Az alapértelmezett kultúra azonban felülírható a Kultúra paraméterrel.
Paraméterek
-Culture
Megadja a CIM-munkamenethez használandó felhasználói felületi kultúrát. Adja meg a paraméter értékét az alábbi formátumok egyikével:
- Egy kulturális név formátuma
<languagecode2>-<country/regioncode2>
, például "EN-US". - Egy CultureInfo objektumot tartalmazó változó.
- Egy CultureInfo objektumot lekérő parancs, például Get-Culture
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EncodePortInServicePrincipalName
Azt jelzi, hogy a Kerberos-kapcsolat olyan szolgáltatáshoz csatlakozik, amelynek egyszerű szolgáltatásneve (SPN) tartalmazza a szolgáltatásport számát. Ez a kapcsolattípus nem gyakori.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Encoding
A WsMan protokollhoz használt kódolást adja meg. A paraméter elfogadható értékei a következők: Alapértelmezett, Utf8 vagy Utf16.
Type: | PacketEncoding |
Accepted values: | Default, Utf8, Utf16 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HttpPrefix
A HTTP URL-címnek a számítógép neve és portszáma utáni részét adja meg. A módosítás nem gyakori. Alapértelmezés szerint ennek a paraméternek az értéke /wsman.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Impersonation
DCOM-munkamenetet hoz létre a Windows Management Instrumentation (WMI) számára megszemélyesítéssel.
A paraméter érvényes értékei a következők:
- Alapértelmezett: A DCOM a megszemélyesítési szintet a normál biztonsági egyeztetési algoritmus használatával választhatja ki.
- Nincs: Az ügyfél névtelen a kiszolgálón. A kiszolgálói folyamat megszemélyesítheti az ügyfelet, de a megszemélyesítési jogkivonat nem tartalmaz információt, és nem használható.
- Azonosítás: Lehetővé teszi az objektumok számára a hívó hitelesítő adatainak lekérdezését.
- Megszemélyesítés: Lehetővé teszi, hogy az objektumok a hívó hitelesítő adatait használják.
- Meghatalmazott: Lehetővé teszi, hogy az objektumok más objektumok számára is lehetővé tegyék a hívó hitelesítő adatainak használatát.
Ha nincs megadva megszemélyesítés, a New-CimSession
parancsmag a Megszemélyesítés értékét használja.
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
A WsMan XML-üzenetek méretkorlátját adja meg mindkét irányban.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoEncryption
Megadja, hogy az adattitkosítás ki van-e kapcsolva.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PacketIntegrity
Megadja, hogy a WMI-hez létrehozott DCOM-munkamenet a Component Object Model (COM) PacketIntegrity funkciót használja. Alapértelmezés szerint a DCOM használatával létrehozott ÖSSZES CIM-munkamenetben a PacketIntegrity paraméter értéke True.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PacketPrivacy
Létrehoz egy DCOM-munkamenetet a WMI-nek a COM PacketPrivacy használatával. Alapértelmezés szerint a DCOM használatával létrehozott ÖSSZES CIM-munkamenetben a PacketPrivacy paraméter értéke igaz.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Protocol
Megadja a használni kívánt protokollt. A paraméter elfogadható értékei a következők: DCOM, Default vagy Wsman.
Type: | ProtocolType |
Accepted values: | Dcom, Default, Wsman |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyAuthentication
Megadja a proxyfeloldáshoz használandó hitelesítési módszert. A paraméter elfogadható értékei a következők: Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain vagy 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
Megadja egy felhasználói fiók (x.509) digitális nyilvános kulcsú tanúsítványát proxyhitelesítéshez. Adja meg a tanúsítvány ujjlenyomatát. A tanúsítványok az ügyféltanúsítvány-alapú hitelesítésben használatosak. Csak helyi felhasználói fiókokhoz rendelhetők, és nem működnek tartományi fiókokkal.
Tanúsítvány ujjlenyomatának lekéréséhez használja a Get-Item
Get-ChildItem
PowerShell Cert: meghajtó parancsmagjait.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCredential
Megadja a proxyhitelesítéshez használandó hitelesítő adatokat. Adja meg az alábbiak egyikét:
- PSCredential objektumot tartalmazó változó.
- PSCredential objektumot lekérő parancs, például
Get-Credential
Ha ez a beállítás nincs beállítva, akkor nem adhat meg hitelesítő adatokat.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyType
Megadja a használni kívánt állomásnévfeloldási mechanizmust. A paraméter elfogadható értékei a következők: None, WinHttp, Auto vagy InternetExplorer.
Ennek a paraméternek az alapértelmezett értéke az 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
Azt jelzi, hogy HTTPS-kapcsolaton keresztüli csatlakozáskor az ügyfél nem ellenőrzi, hogy a kiszolgálói tanúsítványt megbízható hitelesítésszolgáltató (CA) írta-e alá.
Ezt a paramétert csak akkor használja, ha a távoli számítógép megbízható egy másik mechanizmussal, például ha a távoli számítógép egy fizikailag biztonságos és elkülönített hálózat része, vagy ha a távoli számítógép megbízható gazdagépként szerepel a WinRM-konfigurációban.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkipCNCheck
Azt jelzi, hogy a kiszolgáló tanúsítványának köznapi neve (CN) nem felel meg a kiszolgáló gazdagépnevének. Ezt a paramétert csak a HTTPS protokollt használó megbízható számítógépek esetén használja a távoli műveletekhez.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkipRevocationCheck
Azt jelzi, hogy a rendszer kihagyja a kiszolgálótanúsítványok visszavonási ellenőrzését. Ezt a paramétert csak megbízható számítógépekre használja.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UICulture
Megadja a CIM-munkamenethez használandó felhasználói felületi kultúrát. Adja meg a paraméter értékét az alábbi formátumok egyikével:
- Egy kulturális név formátuma
<languagecode2>-<country/regioncode2>
, például "EN-US". - Egy CultureInfo objektumot tartalmazó változó.
- Egy CultureInfo objektumot lekérő parancs, például
Get-Culture
.
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UseSsl
Azt jelzi, hogy ssl használatával kell kapcsolatot létesíteni a távoli számítógéppel. Alapértelmezés szerint az SSL nem használatos. A WsMan titkosítja a hálózaton keresztül továbbított összes tartalmat, még AKKOR is, ha HTTP-t használ.
Ezzel a paraméterrel a HTTP helyett a HTTPS további védelmét adhatja meg. Ha az SSL nem érhető el a kapcsolathoz használt porton, és ezt a paramétert adja meg, a parancs meghiúsul.
Ezt a paramétert csak akkor ajánlott használni, ha nincs megadva a PacketPrivacy paraméter.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Bevitelek
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
Ez a parancsmag egy olyan objektumot ad vissza, amely a CIM-munkamenet beállításainak adatait tartalmazza.
Jegyzetek
A PowerShell a következő aliasokat New-CimSessionOption
tartalmazza:
- Windows:
ncso
Ez a parancsmag csak Windows-platformokon érhető el.
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: