Register-PSSessionConfiguration

Referentie

Module:: Microsoft.PowerShell.Core

Hiermee maakt en registreert u een nieuwe sessieconfiguratie.

Syntax

Register-PSSessionConfiguration
        [-ProcessorArchitecture <String>]
        [-SessionType <PSSessionType>]
        [-Name] <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>]

Register-PSSessionConfiguration
        [-ProcessorArchitecture <String>]
        [-Name] <String>
        [-AssemblyName] <String>
        [-ApplicationBase <String>]
        [-ConfigurationTypeName] <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>]

Register-PSSessionConfiguration
        [-ProcessorArchitecture <String>]
        [-Name] <String>
        [-RunAsCredential <PSCredential>]
        [-ThreadApartmentState <ApartmentState>]
        [-ThreadOptions <PSThreadOptions>]
        [-AccessMode <PSSessionConfigurationAccessMode>]
        [-UseSharedProcess]
        [-StartupScript <String>]
        [-MaximumReceivedDataSizePerCommandMB <Double>]
        [-MaximumReceivedObjectSizeMB <Double>]
        [-SecurityDescriptorSddl <String>]
        [-ShowSecurityDescriptorUI]
        [-Force]
        [-NoServiceRestart]
        [-TransportOption <PSTransportOption>]
        -Path <String>
        [-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_Configurations voor meer informatie over sessieconfiguraties. Zie about_Session_Configuration_Files voor 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 New-PSSession -ConfigurationName newshellu .

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 New-PSSession opdracht.

Voorbeeld 3: Een sessieconfiguratie registreren

In dit voorbeeld wordt de Beheer Shell-sessieconfiguratie geregistreerd.

De $sessionParams variabele is een hashtabel met alle parameterwaarden. Deze hashtabel wordt doorgegeven aan de cmdlet met behulp van PowerShell-splatting. De Register-PSSessionConfiguration opdracht gebruikt de parameter SecurityDescritorSDDL om de SDDL op te geven in de waarde van de $sddl variabele en de parameter MaximumReceivedObjectSizeMB om de limiet voor de objectgrootte 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) geeft de items in het WSMan:\LocalHost\PlugIn pad weer. 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 configuratie van de WithProfile-sessie . 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_Profiles voor meer informatie over profielen. Zie about_Scopes voor 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 aanvaardbare waarden voor deze parameter zijn:

Disabled. 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.
Externe. 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 Enable-PSRemoting cmdlet 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.

Type:	PSSessionConfigurationAccessMode
Accepted values:	Disabled, Local, Remote
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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 klasse System.Management.Automation.Remoting.PSSessionConfiguration implementeren.

Als u het assemblybestand (*.dll) wilt opgeven dat het configuratietype implementeert, geeft u de AssemblyName - en ApplicationBase-parameters 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 klasse DefaultRemotePowerShellConfiguration gebruikt voor de sessieconfiguratie.

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

Type:	Nullable<T>[Double]
Position:	Named
Default value:	50
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Nullable<T>[Double]
Position:	Named
Default value:	10
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ModulesToImport

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

Standaard wordt alleen Microsoft.PowerShell.Core geïmporteerd in sessies. Tenzij de cmdlets zijn uitgesloten, kunt Import-Module u modules toevoegen 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 sleutel ModulesToImport 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.

Type:	Object[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoServiceRestart

Start de WinRM-service niet opnieuw op en onderdrukt de prompt om de service opnieuw op te starten.

Wanneer u een Register-PSSessionConfiguration opdracht uitvoert, wordt u standaard gevraagd om de WinRM-service opnieuw te starten om de nieuwe sessieconfiguratie effectief te maken. Totdat de WinRM-service opnieuw is opgestart, is de nieuwe sessieconfiguratie niet effectief.

Als u de WinRM-service opnieuw wilt starten zonder te vragen, geeft u de parameter Force op. Als u de WinRM-service handmatig opnieuw wilt starten, gebruikt u de Restart-Service cmdlet.

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

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

Type:	String
Aliases:	PA
Accepted values:	x86, amd64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Version
Aliases:	PowerShellVersion
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 parameter ShowSecurityDescriptorUI 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 voor meer informatie over de WSMan-provider Get-Help wsman.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SessionType

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

Lege. 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.
Standaard. 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.
RestrictedRemoteServer. Bevat alleen de volgende cmdlets: Exit-PSSession, , Get-FormatDataGet-Command, Get-Help, Measure-Object, , en Select-ObjectOut-Default. 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.

Type:	PSSessionType
Accepted values:	DefaultRemoteShell, Workflow
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 New-PSSessionOption cmdlet, voorrang op opties die zijn ingesteld in de sessieconfiguratie. Waarden voor sessieopties mogen echter niet groter zijn dan de maximumwaarden die zijn ingesteld in de sessieconfiguratie.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:	PSSessionTypeOption
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 Register-PSSessionConfiguration opdracht hebt ingevoerd en de WinRM-service opnieuw hebt gestart.

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 parameter SecurityDescriptorSDDL en deze parameter niet gebruiken in dezelfde opdracht.

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ThreadApartmentState

Hiermee geeft u de appartementsstatus van de threads in de sessie. De acceptabele waarden voor deze parameter zijn: STA, MTA en Onbekend. De standaardwaarde is Onbekend.

Type:	ApartmentState
Accepted values:	STA, MTA, Unknown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ThreadOptions

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

Standaardinstelling
HergebruikThread
UseCurrentThread
UseNewThread

De standaardwaarde is UseCurrentThread.

Zie de opsomming PSThreadOptions voor meer informatie.

Type:	PSThreadOptions
Accepted values:	Default, UseNewThread, ReuseThread, UseCurrentThread
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TransportOption

Hiermee geeft u de transportoptie.

Deze parameter is geïntroduceerd in PowerShell 3.0.

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

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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 Web Services for Management (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.

Register-PSSessionConfiguration

Syntax

Description

Voorbeelden

Voorbeeld 1: Een configuratie van een NewShell-sessie registreren

Voorbeeld 2: Een MaintenanceShell-sessieconfiguratie registreren

Voorbeeld 3: Een sessieconfiguratie registreren

Voorbeeld 4: Een configuratiecontainerelement retourneren

Voorbeeld 5: Een sessieconfiguratie registreren met een opstartscript

Parameters

-AccessMode

-ApplicationBase

-AssemblyName

-ConfigurationTypeName

-Confirm

-Force

-MaximumReceivedDataSizePerCommandMB

-MaximumReceivedObjectSizeMB

-ModulesToImport

-Name

-NoServiceRestart

-Path

-ProcessorArchitecture

-PSVersion

-RunAsCredential

-SecurityDescriptorSddl

-SessionType

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

Invoerwaarden

Uitvoerwaarden

Notities

Feedback

Aanvullende resources

Register-PSSessionConfiguration

Syntax

Description

Voorbeelden

Voorbeeld 1: Een configuratie van een NewShell-sessie registreren

Voorbeeld 2: Een MaintenanceShell-sessieconfiguratie registreren

Voorbeeld 3: Een sessieconfiguratie registreren

Voorbeeld 4: Een configuratiecontainerelement retourneren

Voorbeeld 5: Een sessieconfiguratie registreren met een opstartscript

Parameters

-AccessMode

-ApplicationBase

-AssemblyName

-ConfigurationTypeName

-Confirm

-Force

-MaximumReceivedDataSizePerCommandMB

-MaximumReceivedObjectSizeMB

-ModulesToImport

-Name

-NoServiceRestart

-Path

-ProcessorArchitecture

-PSVersion

-RunAsCredential

-SecurityDescriptorSddl

-SessionType

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

Invoerwaarden

Uitvoerwaarden

Notities

Verwante koppelingen

Feedback

Aanvullende resources