Delen via

Register-PSSessionConfiguration

Module:
Microsoft.PowerShell.Core Module

Hiermee maakt en registreert u een nieuwe sessieconfiguratie.

Syntax

NameParameterSet (Standaard) 

Register-PSSessionConfiguration
    [-Name] <String>
    [-ProcessorArchitecture <String>]
    [-SessionType <PSSessionType>]
    [-ApplicationBase <String>]
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-PSVersion <Version>]
    [-SessionTypeOption <PSSessionTypeOption>]
    [-TransportOption <PSTransportOption>]
    [-ModulesToImport <Object[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AssemblyNameParameterSet 

Register-PSSessionConfiguration
    [-Name] <String>
    [-AssemblyName] <String>
    [-ConfigurationTypeName] <String>
    [-ProcessorArchitecture <String>]
    [-ApplicationBase <String>]
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-PSVersion <Version>]
    [-SessionTypeOption <PSSessionTypeOption>]
    [-TransportOption <PSTransportOption>]
    [-ModulesToImport <Object[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SessionConfigurationFile 

Register-PSSessionConfiguration
    [-Name] <String>
    -Path <String>
    [-ProcessorArchitecture <String>]
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-TransportOption <PSTransportOption>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

De Register-PSSessionConfiguration cmdlet maakt en registreert een nieuwe sessieconfiguratie op de lokale computer. Dit is een geavanceerde cmdlet die u kunt gebruiken om aangepaste sessies te maken voor externe gebruikers.

Elke PowerShell-sessie (PSSession) maakt gebruik van een sessieconfiguratie, ook wel een eindpunt genoemd. Wanneer gebruikers een sessie maken die verbinding maakt met de computer, kunnen ze een sessieconfiguratie selecteren of de standaardsessieconfiguratie gebruiken die is geregistreerd wanneer u externe communicatie van PowerShell inschakelt. Gebruikers kunnen ook de $PSSessionConfigurationName voorkeursvariabele instellen, waarmee een standaardconfiguratie wordt opgegeven voor externe sessies die in de huidige sessie zijn gemaakt.

De sessieconfiguratie definieert de omgeving voor de externe sessie. De configuratie kan bepalen welke opdrachten en taalelementen beschikbaar zijn in de sessie en kan instellingen bevatten die de computer beveiligen, zoals de opdrachten en taalelementen die de hoeveelheid gegevens beperken die de sessie op afstand kan ontvangen in één object of opdracht. De beveiligingsdescriptor van de sessieconfiguratie bepaalt welke gebruikers gemachtigd zijn om de sessieconfiguratie te gebruiken.

U kunt de elementen van de configuratie definiëren met behulp van een assembly die een nieuwe configuratieklasse implementeert en met behulp van een script dat in de sessie wordt uitgevoerd. Vanaf PowerShell 3.0 kunt u ook een sessieconfiguratiebestand gebruiken om de sessieconfiguratie te definiëren.

Zie about_Session_Configurationsvoor meer informatie over sessieconfiguraties. Zie about_Session_Configuration_Filesvoor meer informatie over sessieconfiguratiebestanden.

Voorbeelden

Voorbeeld 1: Een configuratie van een NewShell-sessie registreren

In dit voorbeeld registreren we de configuratie van de NewShell sessie. De parameters AssemblyName en ApplicationBase geven de locatie van het MyShell.dll-bestand op, waarmee de cmdlets en providers in de sessieconfiguratie worden opgegeven. De parameter ConfigurationTypeName geeft de configuratieklasse op die moet worden gebruikt vanuit de assembly.

$sessionConfiguration = @{
    Name='NewShell'
    ApplicationBase='C:\MyShells\'
    AssemblyName='MyShell.dll'
    ConfigurationTypeName='MyClass'
}
Register-PSSessionConfiguration @sessionConfiguration

Als u deze configuratie wilt gebruiken, typt u New-PSSession -ConfigurationName NewShell.

Voorbeeld 2: Een MaintenanceShell-sessieconfiguratie registreren

In dit voorbeeld wordt de MaintenanceShell- sessieconfiguratie op de lokale computer geregistreerd. De parameter StartupScript geeft het Maintenance.ps1 script op.

Register-PSSessionConfiguration -Name MaintenanceShell -StartupScript C:\ps-test\Maintenance.ps1

Wanneer een gebruiker een New-PSSession opdracht gebruikt en de MaintenanceShell-configuratie selecteert, wordt het Maintenance.ps1 script uitgevoerd in de nieuwe sessie. Het script kan de sessie configureren. Dit omvat het importeren van modules en het instellen van het uitvoeringsbeleid voor de sessie. Als het script fouten genereert, inclusief niet-afsluitfouten, mislukt de opdracht New-PSSession.

Voorbeeld 3: Een sessieconfiguratie registreren

In dit voorbeeld wordt de AdminShell sessieconfiguratie geregistreerd.

De $sessionParams variabele is een hashtabel met alle parameterwaarden. Deze hashtabel wordt doorgegeven aan de cmdlet met behulp van PowerShell-splatting. De opdracht Register-PSSessionConfiguration gebruikt de parameter SecurityDescritorSDDL om de SDDL op te geven in de waarde van de variabele $sddl en de parameter MaximumReceivedObjectSizeMB om de objectgroottelimiet te verhogen. Ook wordt de parameter StartupScript gebruikt om een script op te geven waarmee de sessie wordt geconfigureerd.

$sddl = "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;FASA;GWGX;;;WD)"
$sessionParams = @{
    Name="AdminShell"
    SecurityDescriptorSDDL=$sddl
    MaximumReceivedObjectSizeMB=20
    StartupScript="C:\scripts\AdminShell.ps1"
}
Register-PSSessionConfiguration @sessionParams

Voorbeeld 4: Een configuratiecontainerelement retourneren

In dit voorbeeld ziet u hoe u de MaintenanceShell--configuratie registreert. Register-PSSessionConfiguration retourneert een WSManConfigContainerElement-object dat is opgeslagen in de $s variabele. Format-List geeft alle eigenschappen van het geretourneerde object weer. De eigenschap PSPath laat zien dat het object is opgeslagen in een map van het WSMan-station. Get-ChildItem (alias dir) worden de items in het pad WSMan:\LocalHost\PlugIn weergegeven. Deze omvatten de nieuwe MaintenanceShell-configuratie en de twee standaardconfiguraties die bij PowerShell worden geleverd.

$s = Register-PSSessionConfiguration -Name MaintenanceShell -StartupScript C:\ps-test\Maintenance.ps1
$s | Format-List -Property *
dir WSMan:\LocalHost\Plugin

PSPath            : Microsoft.WSMan.Management\WSMan::localhost\Plugin\MaintenanceShell
PSParentPath      : Microsoft.WSMan.Management\WSMan::localhost\Plugin
PSChildName       : MaintenanceShell
PSDrive           : WSMan
PSProvider        : Microsoft.WSMan.Management\WSMan
PSIsContainer     : True
Keys              : {Name=MaintenanceShell}
Name              : MaintenanceShell
TypeNameOfElement : Container

Name                      Type                 Keys
----                      ----                 ----
MaintenanceShell          Container            {Name=MaintenanceShell}
microsoft.powershell      Container            {Name=microsoft.powershell}
microsoft.powershell32    Container            {Name=microsoft.powershell32}

Voorbeeld 5: Een sessieconfiguratie registreren met een opstartscript

In dit voorbeeld maken en registreren we de WithProfile sessieconfiguratie. Met de parameter StartupScript wordt PowerShell om het opgegeven script uit te voeren voor elke sessie die gebruikmaakt van de sessieconfiguratie.

Register-PSSessionConfiguration -Name WithProfile -StartupScript Add-Profile.ps1

Het script bevat één opdracht die gebruikmaakt van dot sourcing om het CurrentUserAllHosts-profiel van de gebruiker uit te voeren in het huidige bereik van de sessie.

Zie about_Profilesvoor meer informatie over profielen. Zie about_Scopesvoor meer informatie over puntbronnen.

Parameters

-AccessMode

Hiermee wordt de sessieconfiguratie ingeschakeld en uitgeschakeld en wordt bepaald of deze kan worden gebruikt voor externe of lokale sessies op de computer. De acceptabele waarden voor deze parameter zijn:

  • Uitgeschakeld. Hiermee schakelt u de sessieconfiguratie uit. Het kan niet worden gebruikt voor externe of lokale toegang tot de computer.
  • Lokaal. Hiermee kunnen gebruikers van de lokale computer de sessieconfiguratie gebruiken om een lokale loopbacksessie op dezelfde computer te maken, maar weigert de toegang tot externe gebruikers.
  • Afgelegen. Hiermee kunnen lokale en externe gebruikers de sessieconfiguratie gebruiken om sessies te maken en opdrachten uit te voeren op deze computer.

De standaardwaarde is Remote.

Andere cmdlets kunnen de waarde van deze parameter later overschrijven. De cmdlet Enable-PSRemoting biedt bijvoorbeeld externe toegang tot alle sessieconfiguraties, de Enable-PSSessionConfiguration-cmdlet schakelt sessieconfiguraties in en de Disable-PSRemoting cmdlet voorkomt externe toegang tot alle sessieconfiguraties.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Parametereigenschappen

Type:PSSessionConfigurationAccessMode
Default value:None
Geaccepteerde waarden:Disabled, Local, Remote
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ApplicationBase

Hiermee geeft u het pad van het assemblybestand (*.dll) op dat is opgegeven in de waarde van de parameter AssemblyName. Gebruik deze parameter wanneer de waarde van de parameter AssemblyName geen pad bevat. De standaardwaarde is de huidige map.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
AssemblyNameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-AssemblyName

Hiermee geeft u de naam van een assemblybestand (*.dll) waarin het configuratietype is gedefinieerd. U kunt het pad van de .dll opgeven in deze parameter of in de waarde van de parameter ApplicationBase.

Deze parameter is vereist wanneer u de parameter ConfigurationTypeName opgeeft.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

AssemblyNameParameterSet
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ConfigurationTypeName

Hiermee geeft u de volledig gekwalificeerde naam van het Microsoft .NET Framework-type dat voor deze configuratie wordt gebruikt. Het type dat u opgeeft, moet de System.Management.Automation.Remoting.PSSessionConfiguration klasse implementeren.

Als u het assemblybestand (*.dll) wilt opgeven dat het configuratietype implementeert, geeft u de parameters AssemblyName en ApplicationBase- op.

Als u een type maakt, kunt u meer aspecten van de sessieconfiguratie beheren, zoals het blootstellen of verbergen van bepaalde parameters van cmdlets, of het instellen van gegevensgrootte- en objectgroottelimieten die gebruikers niet kunnen overschrijven.

Als u deze parameter weglaat, wordt de DefaultRemotePowerShellConfiguration-klasse gebruikt voor de sessieconfiguratie.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

AssemblyNameParameterSet
Position:2
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Force

Onderdrukt alle gebruikersprompts en start de WinRM--service opnieuw zonder te vragen. Als u de service opnieuw start, wordt de configuratiewijziging effectief.

Als u een herstart wilt voorkomen en de prompt voor opnieuw opstarten wilt onderdrukken, geeft u de parameter NoServiceRestart op.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-MaximumReceivedDataSizePerCommandMB

Hiermee geeft u een limiet op voor de hoeveelheid gegevens die in één externe opdracht naar deze computer kan worden verzonden. Voer de gegevensgrootte in megabytes (MB) in. De standaardwaarde is 50 MB.

Als een gegevensgroottelimiet is gedefinieerd in het configuratietype dat is opgegeven in de parameter ConfigurationTypeName, wordt de limiet in het configuratietype gebruikt en wordt de waarde van deze parameter genegeerd.

Parametereigenschappen

Type:

Nullable<T>[Double]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-MaximumReceivedObjectSizeMB

Hiermee geeft u een limiet op voor de hoeveelheid gegevens die in één object naar deze computer kan worden verzonden. Voer de gegevensgrootte in megabytes in. De standaardwaarde is 10 MB.

Als een objectgroottelimiet is gedefinieerd in het configuratietype dat is opgegeven in de parameter ConfigurationTypeName, wordt de limiet in het configuratietype gebruikt en wordt de waarde van deze parameter genegeerd.

Parametereigenschappen

Type:

Nullable<T>[Double]

Default value:10
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ModulesToImport

Hiermee geeft u de modules op die automatisch worden geïmporteerd in sessies die gebruikmaken van de sessieconfiguratie.

Standaard worden alleen Microsoft.PowerShell.Core- geïmporteerd in sessies. Tenzij de cmdlets zijn uitgesloten, kunt u Import-Module gebruiken om modules toe te voegen aan de sessie.

De modules die in deze parameterwaarde zijn opgegeven, worden geïmporteerd naast modules die zijn opgegeven door de parameter SessionType en modules die worden vermeld in de ModulesToImport-sleutel in het sessieconfiguratiebestand (New-PSSessionConfigurationFile). Instellingen in het sessieconfiguratiebestand kunnen echter de opdrachten verbergen die door modules worden geëxporteerd of voorkomen dat gebruikers ze gebruiken.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Parametereigenschappen

Type:

Object[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
AssemblyNameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

Hiermee geeft u een naam voor de sessieconfiguratie. Deze parameter is vereist.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-NoServiceRestart

De bedoeling van deze parameter is om te voorkomen dat de WinRM--service opnieuw wordt opgestart. Deze functionaliteit is niet geïmplementeerd.

Deze functionaliteit is geïmplementeerd in PowerShell 7.5.0-preview.4, maar er is geen plan om deze wijziging terug te sturen naar Windows PowerShell 5.1.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Path

Hiermee geeft u het pad en de bestandsnaam van een sessieconfiguratiebestand (.pssc), zoals een gemaakt door New-PSSessionConfigurationFile. Als u het pad weglaat, is de standaardwaarde de huidige map.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SessionConfigurationFile
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ProcessorArchitecture

Bepaalt of een 32-bits of 64-bits versie van het PowerShell-proces wordt gestart in sessies die gebruikmaken van deze sessieconfiguratie. De acceptabele waarden voor deze parameter zijn: x86 (32-bits) en AMD64 (64-bits). De standaardwaarde wordt bepaald door de processorarchitectuur van de computer waarop de sessieconfiguratie wordt gehost.

U kunt deze parameter gebruiken om een 32-bits sessie te maken op een 64-bits computer. Pogingen om een 64-bits proces te maken op een 32-bits computer mislukken.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:x86, amd64
Ondersteunt jokertekens:False
DontShow:False
Aliassen:PA

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PSVersion

Hiermee geeft u de versie van PowerShell op in sessies die gebruikmaken van deze sessieconfiguratie.

De waarde van deze parameter heeft voorrang op de waarde van de PowerShellVersion sleutel in het sessieconfiguratiebestand.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Parametereigenschappen

Type:Version
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:PowerShell-versie

Parametersets

NameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
AssemblyNameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RunAsCredential

Hiermee geeft u referenties voor opdrachten in de sessie. Opdrachten worden standaard uitgevoerd met de machtigingen van de huidige gebruiker.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Parametereigenschappen

Type:PSCredential
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SecurityDescriptorSddl

Hiermee geeft u een SDDL-tekenreeks (Security Descriptor Definition Language) op voor de configuratie.

Deze tekenreeks bepaalt de machtigingen die vereist zijn voor het gebruik van de nieuwe sessieconfiguratie. Als u een sessieconfiguratie in een sessie wilt gebruiken, moeten gebruikers ten minste beschikken over de machtiging Uitvoeren (aanroepen) voor de configuratie.

Als de beveiligingsdescriptor complex is, kunt u overwegen om de ShowSecurityDescriptorUI parameter te gebruiken in plaats van deze parameter. U kunt beide parameters niet gebruiken in dezelfde opdracht.

Als u deze parameter weglaat, wordt de SDDL-hoofdmap voor de WinRM--service gebruikt voor deze configuratie. Gebruik de WSMan-provider om de SDDL-hoofdmap weer te geven of te wijzigen. Bijvoorbeeld Get-Item WSMan:\localhost\service\rootSDDL. Typ Get-Help WSManvoor meer informatie over de WSMan-provider.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SessionType

Hiermee geeft u het type sessie dat wordt gemaakt met behulp van de sessieconfiguratie. De acceptabele waarden voor deze parameter zijn:

  • Leeg. Er worden standaard geen modules aan de sessie toegevoegd. Gebruik de parameters van deze cmdlet om modules, functies, scripts en andere functies toe te voegen aan de sessie.
  • Verstek. Voegt Microsoft.PowerShell.Core toe aan de sessie. Deze module bevat de Import-Module cmdlet die gebruikers kunnen gebruiken om andere modules te importeren, tenzij u de cmdlet expliciet verbiedt.
  • Beperkte RemoteServer. Bevat alleen de volgende cmdlets: Exit-PSSession, Get-Command, Get-FormatData, Get-Help, Measure-Object, Out-Defaulten Select-Object. Gebruik een script of assembly of de sleutels in het sessieconfiguratiebestand om modules, functies, scripts en andere functies toe te voegen aan de sessie.

De standaardwaarde is Standaard.

De waarde van deze parameter heeft voorrang op de waarde van de SessionType-sleutel in het sessieconfiguratiebestand.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Parametereigenschappen

Type:PSSessionType
Default value:None
Geaccepteerde waarden:DefaultRemoteShell, Workflow
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SessionTypeOption

Hiermee geeft u typespecifieke opties voor de sessieconfiguratie. Voer een sessietypeoptiesobject in, zoals het PSWorkflowExecutionOption-object dat door de New-PSWorkflowExecutionOption cmdlet wordt geretourneerd.

De opties van sessies die gebruikmaken van de sessieconfiguratie worden bepaald door de waarden van sessieopties en de opties voor sessieconfiguratie. Tenzij opgegeven, hebben opties die zijn ingesteld in de sessie, zoals met behulp van de cmdlet New-PSSessionOption, voorrang op opties die zijn ingesteld in de sessieconfiguratie. Waarden voor sessieopties kunnen echter niet groter zijn dan de maximumwaarden die zijn ingesteld in de sessieconfiguratie.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Parametereigenschappen

Type:PSSessionTypeOption
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
AssemblyNameParameterSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ShowSecurityDescriptorUI

Geeft aan dat met deze cmdlet een eigenschappenvenster wordt weergegeven waarmee u de SDDL voor de sessieconfiguratie kunt maken. Het eigenschappenvenster wordt weergegeven nadat u de opdracht Register-PSSessionConfiguration hebt ingevoerd en start de WinRM--service opnieuw op.

Wanneer u de machtigingen voor de configuratie instelt, moet u er rekening mee houden dat gebruikers ten minste de machtiging Uitvoeren (Aanroepen) moeten hebben om de sessieconfiguratie in een sessie te kunnen gebruiken.

U kunt de SecurityDescriptorSDDL- parameter en deze parameter niet gebruiken in dezelfde opdracht.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-StartupScript

Hiermee geeft u het volledig gekwalificeerde pad van een PowerShell-script. Het opgegeven script wordt uitgevoerd in de nieuwe sessie die gebruikmaakt van de sessieconfiguratie.

U kunt het script gebruiken om de sessie ook te configureren. Als het script een fout genereert, zelfs een niet-afsluitfout, wordt de sessie niet gemaakt en mislukt de New-PSSession opdracht.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ThreadApartmentState

Hiermee geeft u de appartementsstatus van de threadingmodule die moet worden gebruikt. Acceptabele waarden zijn:

  • Onbekend
  • MTA
  • STA

Parametereigenschappen

Type:ApartmentState
Default value:None
Geaccepteerde waarden:STA, MTA, Unknown
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ThreadOptions

Hiermee geeft u op hoe threads worden gemaakt en gebruikt wanneer een opdracht wordt uitgevoerd in de sessie. De acceptabele waarden voor deze parameter zijn:

  • Verstek
  • HergebruikThread
  • GebruikHuidigeDraad
  • GebruikNewThread

De standaardwaarde is UseCurrentThread.

Zie OPSOMMING PSThreadOptionsvoor meer informatie.

Parametereigenschappen

Type:PSThreadOptions
Default value:None
Geaccepteerde waarden:Default, UseNewThread, ReuseThread, UseCurrentThread
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-TransportOption

Hiermee geeft u de transportoptie.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Parametereigenschappen

Type:PSTransportOption
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-UseSharedProcess

Gebruik slechts één proces om alle sessies te hosten die door dezelfde gebruiker zijn gestart en dezelfde sessieconfiguratie te gebruiken. Standaard wordt elke sessie gehost in een eigen proces.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

WSManConfigContainerElement

Notities

Als u deze cmdlet wilt uitvoeren, moet u PowerShell starten met behulp van de optie Als administrator uitvoeren.

Met deze cmdlet wordt XML gegenereerd die een invoegtoepassing webservices voor beheer (WS-Management) vertegenwoordigt en de XML verzendt naar WS-Management, waarmee de invoegtoepassing op de lokale computer (New-Item WSMan:\localhost\plugin) wordt geregistreerd.

De eigenschappen van een sessieconfiguratieobject variëren met de opties die zijn ingesteld voor de sessieconfiguratie en de waarden van deze opties. Daarnaast hebben sessieconfiguraties die gebruikmaken van een sessieconfiguratiebestand aanvullende eigenschappen.