New-PSSessionOption

Sintassi

New-PSSessionOption
   [-MaximumRedirection <Int32>]
   [-NoCompression]
   [-NoMachineProfile]
   [-Culture <CultureInfo>]
   [-UICulture <CultureInfo>]
   [-MaximumReceivedDataSizePerCommand <Int32>]
   [-MaximumReceivedObjectSize <Int32>]
   [-OutputBufferingMode <OutputBufferingMode>]
   [-MaxConnectionRetryCount <Int32>]
   [-ApplicationArguments <PSPrimitiveDictionary>]
   [-OpenTimeout <Int32>]
   [-CancelTimeout <Int32>]
   [-IdleTimeout <Int32>]
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <AuthenticationMechanism>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [-IncludePortInSPN]
   [<CommonParameters>]

Descrizione

Il New-PSSessionOption cmdlet crea un oggetto che contiene opzioni avanzate per una sessione gestita dall'utente (PSSession). È possibile usare l'oggetto come valore del parametro SessionOption dei cmdlet che creano una sessione PSSession, ad esempio New-PSSession, Enter-PSSessione Invoke-Command.

Senza parametri, New-PSSessionOption genera un oggetto contenente i valori predefiniti per tutte le opzioni. Poiché ogni proprietà può essere modificata, è possibile usare l'oggetto risultante come modello e creare oggetti opzione standard per l'organizzazione.

È anche possibile salvare un oggetto SessionOption nella $PSSessionOption variabile di preferenza. I valori di questa variabile stabiliscono nuovi valori predefiniti per le opzioni della sessione. Sono efficaci quando non vengono impostate opzioni di sessione per la sessione e hanno la precedenza sulle opzioni impostate nella configurazione della sessione, ma è possibile eseguirne l'override specificando le opzioni di sessione o un oggetto SessionOption in un cmdlet che crea una sessione. Per altre informazioni sulla variabile di $PSSessionOption preferenza, vedere about_Preference_Variables.

Quando si usa un oggetto SessionOption in un cmdlet che crea una sessione, i valori delle opzioni di sessione hanno la precedenza sui valori predefiniti per le sessioni impostate nella $PSSessionOption variabile preferenza e nella configurazione della sessione. Non hanno tuttavia la precedenza sui valori, sulle quote o sui limiti massimi impostati nella configurazione di sessione. Per altre informazioni sulle configurazioni di sessione, vedere about_Session_Configurations.

Esempio

Esempio 1: Creare un'opzione di sessione predefinita

Questo comando crea un oggetto SessionOption con i valori predefiniti.

New-PSSessionOption

MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

Esempio 2: Configurare una sessione usando un oggetto opzione di sessione

In questo esempio viene illustrato come utilizzare un oggetto SessionOption per configurare una sessione.

$pso = New-PSSessionOption -Culture "fr-fr" -MaximumReceivedObjectSize 10MB
New-PSSession -ComputerName Server01 -SessionOption $pso

Il primo comando crea un nuovo oggetto SessionOption e lo salva nel valore della $pso variabile. Il secondo comando usa il New-PSSession cmdlet per creare una sessione nel computer remoto Server01. Il comando usa l'oggetto SessionOption nel valore della $pso variabile come valore del parametro SessionOption del comando.

Esempio 3: Avviare una sessione interattiva

Questo comando usa il Enter-PSSession cmdlet per avviare una sessione interattiva con il computer Server01.

Enter-PSSession -ComputerName Server01 -SessionOption (New-PSSessionOption -NoEncryption -NoCompression)

Il valore del parametro SessionOption è un New-PSSessionOption comando con i parametri NoEncryption e NoCompression .

Il New-PSSessionOption comando è racchiuso tra parentesi per assicurarsi che venga eseguito prima del Enter-PSSession comando.

Esempio 4: Modificare un oggetto opzione di sessione

In questo esempio viene illustrato che è possibile modificare l'oggetto SessionOption . Tutte le proprietà hanno valori di lettura/scrittura.

$a = New-PSSessionOption
$a.OpenTimeout

Days              : 0
Hours             : 0
Minutes           : 3
Seconds           : 0
Milliseconds      : 0
Ticks             : 1800000000
TotalDays         : 0.00208333333333333
TotalHours        : 0.05
TotalMinutes      : 3
TotalSeconds      : 180
TotalMilliseconds : 180000

$a.UICulture = (Get-UICulture)
$a.OpenTimeout = (New-Timespan -Minutes 4)
$a.MaximumConnectionRedirectionCount = 1
$a

MaximumConnectionRedirectionCount : 1
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         : en-US
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:04:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

Usare questo metodo per creare un oggetto sessione standard per l'organizzazione e quindi creare versioni personalizzate di tale oggetto per particolari utilizzi.

Esempio 5: Creare una variabile di preferenza

Questo comando crea una $PSSessionOption variabile di preferenza.

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

Quando la $PSSessionOption variabile di preferenza viene impostata nella sessione, stabilisce i valori predefiniti per le opzioni nelle sessioni create con i New-PSSessioncmdlet , Enter-PSSessione Invoke-Command .

Per rendere disponibile la $PSSessionOption variabile in tutte le sessioni, aggiungerla alla sessione di PowerShell e al profilo di PowerShell.

Per altre informazioni sulla variabile di $PSSessionOption preferenza, vedere about_Preference_Variables. Per altre informazioni sui profili, vedere about_Profiles.

Esempio 6: Soddisfare i requisiti per una configurazione sessione remota

In questo esempio viene illustrato come usare un oggetto SessionOption per soddisfare i requisiti per una configurazione di sessione remota.

$skipCN = New-PSSessionOption -SkipCNCheck
New-PSSession -ComputerName 171.09.21.207 -UseSSL -Credential Domain01\User01 -SessionOption $SkipCN

Il primo comando usa il New-PSSessionOption cmdlet per creare un oggetto SessionOption con la proprietà SkipCNCheck . Il comando salva l'oggetto sessione risultante nella $skipCN variabile .

Il secondo comando usa il New-PSSession cmdlet per creare una nuova sessione in un computer remoto. La $skipCN variabile check viene usata nel valore del parametro SessionOption .

Poiché il computer è identificato dal relativo indirizzo IP, il valore del parametro ComputerName non corrisponde ad alcun nome comune nel certificato usato per Secure Sockets Layer (SSL). Di conseguenza, è necessaria l'opzione SkipCNCheck .

Esempio 7: Rendere disponibili argomenti per una sessione remota

In questo esempio viene illustrato come usare il parametro ApplicationArguments del New-PSSessionOption cmdlet per rendere disponibili dati aggiuntivi per la sessione remota.

$team = @{Team="IT"; Use="Testing"}
$TeamOption = New-PSSessionOption -ApplicationArguments $team
$s = New-PSSession -ComputerName Server01 -SessionOption $TeamOption
Invoke-Command -Session $s {$PSSenderInfo.ApplicationArguments}

Name                 Value
----                 -----
Team                 IT
Use                  Testing
PSVersionTable       {CLRVersion, BuildVersion, PSVersion, WSManStackVersion...}

Invoke-Command -Session $s {
  if ($PSSenderInfo.ApplicationArguments.Use -ne "Testing") {
    .\logFiles.ps1
  }
  else {
    "Just testing."
  }
}

Just testing.

Il primo comando crea una tabella hash con due chiavi, Team e Use. Il comando salva la tabella hash nella $team variabile . Per altre informazioni sulle tabelle hash, vedere about_Hash_Tables.

Successivamente, il New-PSSessionOption cmdlet , usando il parametro ApplicationArguments , crea un oggetto SessionOption salvato nella $team variabile . Quando New-PSSessionOption crea l'oggetto opzione di sessione, converte automaticamente la tabella hash nel valore del parametro ApplicationArguments in un PrimitiveDictionary in modo che i dati possano essere trasmessi in modo affidabile alla sessione remota.

Il New-PSSession cmdlet avvia una sessione nel computer Server01. Usa il parametro SessionOption per includere le opzioni nella $teamOption variabile.

Il Invoke-Command cmdlet dimostra che i dati nella $team variabile sono disponibili per i comandi nella sessione remota. I dati sono visualizzati nella proprietà ApplicationArguments della $PSSenderInfo variabile automatica.

L'ultima Invoke-Command mostra come usare i dati.

Parametri

-ApplicationArguments

-CancelTimeout

-Culture

-IdleTimeout

-IncludePortInSPN

-MaxConnectionRetryCount

-MaximumReceivedDataSizePerCommand

-MaximumReceivedObjectSize

-MaximumRedirection

-NoCompression

-NoEncryption

-NoMachineProfile

-OpenTimeout

-OperationTimeout

-OutputBufferingMode

-ProxyAccessType

-ProxyAuthentication

-ProxyCredential

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseUTF16

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

PSSessionOption

Note

Se il parametro SessionOption non viene usato in un comando per creare una sessione PSSession, le opzioni di sessione vengono determinate dai valori delle proprietà della $PSSessionOption variabile di preferenza, se impostata. Per altre informazioni sulla $PSSessionOption variabile, vedere about_Preference_Variables.

Le proprietà di un oggetto configurazione di sessione variano in base alle opzioni impostate per la configurazione di sessione e ai valori di queste opzioni. Le configurazioni di sessione che usano un file di configurazione della sessione hanno anche proprietà aggiuntive.

Collegamenti correlati

• Enter-PSSession
• Invoke-Command
• New-PSSession