Dela via

New-CimSession

  • Referens
Modul:
CimCmdlets

Skapar en CIM-session.

Syntax

New-CimSession
   [-Authentication <PasswordAuthenticationMechanism>]
   [[-Credential] <PSCredential>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]
New-CimSession
   [-CertificateThumbprint <String>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]

Description

Cmdleten New-CimSession skapar en CIM-session. En CIM-session är ett objekt på klientsidan som representerar en anslutning till en lokal dator eller en fjärrdator. CIM-sessionen innehåller information om anslutningen, till exempel ComputerName, protokollet som används för anslutningen, sessions-ID och instans-ID.

Den här cmdleten returnerar ett CIM-sessionsobjekt som kan användas av alla andra CIM-cmdletar.

Exempel

Exempel 1: Skapa en CIM-session med standardalternativ

New-CimSession

Det här kommandot skapar en lokal CIM-session med standardalternativ. Om ComputerName inte har angetts skapar New-CimSession en DCOM-session till den lokala datorn.

Exempel 2: Skapa en CIM-session till en viss dator

New-CimSession -ComputerName Server01

Det här kommandot skapar en CIM-session på den dator som anges av ComputerName. Som standard skapar New-CimSession en WsMan-session när ComputerName- anges.

Exempel 3: Skapa en CIM-session på flera datorer

New-CimSession -ComputerName Server01,Server02,Server03

Det här kommandot skapar en CIM-session till var och en av de datorer som anges av ComputerNamei kommaavgränsad lista.

Exempel 4: Skapa en CIM-session med ett eget namn

Du kan använda det egna namnet på en CIM-session för att enkelt referera till sessionen i andra CIM-cmdletar, till exempel Get-CimSession.

New-CimSession -ComputerName Server01,Server02 -Name FileServers

Get-CimSession -Name File*

Det här kommandot skapar en CIM-fjärrsession till var och en av de datorer som anges av ComputerName, i kommaavgränsad lista och tilldelar ett eget namn till de nya sessionerna genom att ange Namn.

Exempel 5: Skapa en CIM-session till en dator med hjälp av ett PSCredential-objekt

New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate

Det här kommandot skapar en CIM-session på den dator som anges av ComputerName, med hjälp av PSCredential-objektet som anges av Credentialoch den autentiseringstyp som anges av Authentication.

Du kan skapa ett PSCredential-objekt med hjälp av cmdleten Get-Credential.

Exempel 6: Skapa en CIM-session till en dator med en specifik port

New-CimSession -ComputerName Server01 -Port 1234

Det här kommandot skapar en CIM-session till datorn som anges av ComputerName med hjälp av TCP-porten som anges av Port.

Exempel 7: Skapa en CIM-session med DCOM

$SessionOption = New-CimSessionOption -Protocol DCOM

New-CimSession -ComputerName Server1 -SessionOption $SessionOption

Det här kommandot skapar en CIM-session med hjälp av DCOM-protokollet (Distributed COM) i stället för WSMan.

Parametrar

-Authentication

Anger den autentiseringstyp som används för användarens autentiseringsuppgifter. De godtagbara värdena för den här parametern är:

  • Standard
  • Smälta
  • Förhandla
  • Grundläggande
  • Kerberos
  • NtlmDomain
  • CredSsp

Du kan inte använda NtlmDomain-autentiseringstypen för anslutning till den lokala datorn. CredSSP-autentisering är endast tillgängligt i Windows Vista, Windows Server 2008 och senare versioner av Windows.

Varning! CredSSP-autentisering (CredSSP), där användarens autentiseringsuppgifter skickas till en fjärrdator som ska autentiseras, är utformad för kommandon som kräver autentisering på mer än en resurs, till exempel åtkomst till en fjärrnätverksresurs. Den här mekanismen ökar säkerhetsrisken för fjärråtgärden. Om fjärrdatorn komprometteras kan de autentiseringsuppgifter som skickas till den användas för att styra nätverkssessionen.

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

-CertificateThumbprint

Anger certifikatet för den digitala offentliga nyckeln (X.509) för ett användarkonto som har behörighet att utföra den här åtgärden. Ange certifikatets tumavtryck.

Certifikat används i klientcertifikatbaserad autentisering. De kan endast mappas till lokala användarkonton. 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-certifikatprovidern. Mer information om hur du använder PowerShell-certifikatprovidern finns i Get-Help Certificateeller Certifikatprovider.

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

-ComputerName

Anger namnet på den dator som CIM-sessionen ska skapas till. Ange antingen ett datornamn eller flera datornamn avgränsade med kommatecken.

Om ComputerName inte har angetts skapas en CIM-session till den lokala datorn.

Du kan ange värdet för datornamnet i något av följande format:

  • Ett eller flera NetBIOS-namn
  • En eller flera IP-adresser
  • Ett eller flera fullständigt kvalificerade domännamn.

Om datorn finns i en annan domän än användaren måste du ange det fullständigt kvalificerade domännamnet.

Du kan också skicka ett datornamn (inom citattecken) till New-CimSession med hjälp av pipelinen.

Typ:String[]
Alias:CN, ServerName
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Credential

Anger ett användarkonto som har behörighet att utföra den här åtgärden. Om autentiseringsuppgifter inte har angetts används det aktuella användarkontot.

Ange värdet för credential med något av följande format:

  • Ett användarnamn: "User01"
  • Ett domännamn och ett användarnamn: "Domain01\User01"
  • Ett huvudnamn för användaren: "User@Domain.com"
  • Ett PSCredential-objekt, till exempel ett som returneras av Get-Credential-cmdleten.

När du skriver ett användarnamn uppmanas du att ange ett lösenord.

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

-Name

Anger ett eget namn för CIM-sessionen.

Du kan använda namnet för att referera till CIM-sessionen när du använder andra cmdletar, till exempel Get-CimSession cmdlet. Namnet måste inte vara unikt för datorn eller den aktuella sessionen.

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

-OperationTimeoutSec

Varaktighet för vilken cmdleten väntar på ett svar från servern.

Som standard är värdet för den här parametern 0, vilket innebär att cmdleten använder standardvärdet för timeout för servern.

Om parametern OperationTimeoutSec anges till ett värde som är mindre än den robusta tidsgränsen för återförsök på 3 minuter kan nätverksfel som varar mer än värdet för parametern OperationTimeoutSec inte återställas eftersom åtgärden på servern överskrider tidsgränsen innan klienten kan återansluta.

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

-Port

Anger nätverksporten på fjärrdatorn som används för den här anslutningen. Om du vill ansluta till en fjärrdator måste fjärrdatorn lyssna på porten som anslutningen använder. Standardportarna är 5985 (WinRM-porten för HTTP) och 5986 (WinRM-porten för HTTPS).

Innan du använder en alternativ port måste du konfigurera WinRM-lyssnaren på fjärrdatorn så att den lyssnar på den porten. Använd följande kommandon för att konfigurera lyssnaren:

winrm delete winrm/config/listener?Address=*+Transport=HTTP

winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number>"}

Använd inte parametern Port om du inte måste göra det. Portinställningen i kommandot gäller för alla datorer eller sessioner där kommandot körs. En alternativ portinställning kan förhindra att kommandot körs på alla datorer.

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

-SessionOption

Anger avancerade alternativ för den nya CIM-sessionen. Ange namnet på ett CimSessionOption-objekt som skapats med hjälp av cmdleten New-CimSessionOption.

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

-SkipTestConnection

Som standard upprättar New-CimSession-cmdleten en anslutning med en fjärrslutpunkt WS-Management av två skäl: för att kontrollera att fjärrservern lyssnar på portnumret som anges med hjälp av parametern Port och för att verifiera de angivna kontoautentiseringsuppgifterna. Verifieringen utförs med hjälp av en standardåtgärd för WS-Identity. Du kan lägga till parametern SkipTestConnection switch om fjärr-WS-Management-slutpunkten inte kan använda WS-Identify eller om du vill minska viss dataöverföringstid.

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

Utdata

CimSession