New-CimSession

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

Den här cmdleten är endast tillgänglig på Windows-plattformen.

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, det protokoll som används eller olika identifierare.

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

I det här exemplet skapas en lokal CIM-session med standardalternativ. Om ComputerName inte har angetts New-CimSession skapar du en DCOM-session till den lokala datorn.

New-CimSession

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

I det här exemplet skapas en CIM-session på den dator som anges av ComputerName. Som standard New-CimSession skapar en WSMan-session när ComputerName anges.

New-CimSession -ComputerName Server01

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

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

New-CimSession -ComputerName Server01,Server02,Server03

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

Det här exemplet skapar en fjärransluten CIM-session 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.

New-CimSession -ComputerName Server01,Server02 -Name FileServers
Get-CimSession -Name File*

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

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

I det här exemplet skapas en CIM-session på den dator som anges av ComputerName, med hjälp av PSCredential-objektet som anges av Credential och den autentiseringstyp som anges av Autentisering.

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

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

I det här exemplet skapas en CIM-session på den dator som anges av ComputerName med hjälp av den TCP-port som anges av Port.

New-CimSession -ComputerName Server01 -Port 1234

Exempel 7: Skapa en CIM-session med DCOM

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

$SessionOption = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server1 -SessionOption $SessionOption

Parametrar

-Authentication

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

  • Standardvärde
  • Sammandrag
  • Negotiate
  • Basic
  • 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) ä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.

Type:PasswordAuthenticationMechanism
Accepted values:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-CertificateThumbprint

Anger det digitala offentliga nyckelcertifikatet (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 Get-Item du cmdletarna eller Get-ChildItem i PowerShell-certifikatprovidern.

Mer information finns i about_Certificate_Provider.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters: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 Autentiseringsuppgifter 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 cmdleten Get-Credential .

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

Type:PSCredential
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 cmdleten Get-CimSession . Namnet behöver inte vara unikt för datorn eller den aktuella sessionen.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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 är inställd på ett värde som är mindre än den robusta tidsgränsen för återförsök av anslutningen 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.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Port

Anger nätverksporten på fjärrdatorn som används för den här anslutningen. För att 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 för att lyssna 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 portparametern om du inte måste. 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.

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters: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 .

Type:CimSessionOptions
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-SkipTestConnection

Som standard upprättar cmdleten New-CimSession en anslutning med en fjärransluten WS-Management slutpunkt av två skäl: för att kontrollera att fjärrservern lyssnar på portnumret som anges med hjälp av portparametern 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 switchparametern SkipTestConnection om fjärr-WS-Management-slutpunkten inte kan använda WS-Identify eller för att minska viss dataöverföringstid.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

Indata

None

Den här cmdleten accepterar inga indata.

Utdata

CimSession