Register-PSSessionConfiguration

Referentie

Module:: Microsoft.PowerShell.Core

Hiermee wordt een nieuwe sessieconfiguratie gemaakt en geregistreerd.

Syntax

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

Deze cmdlet is alleen beschikbaar op het Windows-platform.

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 met 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 instellingen 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 informatie over sessieconfiguraties. Zie about_Session_Configuration_Files voor informatie over sessieconfiguratiebestanden.

Voorbeelden

Voorbeeld 1: Een NewShell-sessieconfiguratie registreren

In dit voorbeeld registreren we de NewShell-sessieconfiguratie . De parameters AssemblyName en ApplicationBase geven de locatie op van het MyShell.dll-bestand , 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. Met de parameter StartupScript wordt het Maintenance.ps1 script opgegeven.

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 AdminShell-sessieconfiguratie geregistreerd.

De $sessionParams variabele is een hashtabel die alle parameterwaarden bevat. 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 geeft aan 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 sessieconfiguratie WithProfile . 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 dot sourcing gebruikt 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 schakelt u de sessieconfiguratie in en uit en bepaalt u of deze kan worden gebruikt voor externe of lokale sessies op de computer. De aanvaardbare 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.
Lokale. Hiermee kunnen gebruikers van de lokale computer de sessieconfiguratie gebruiken om een lokale loopbacksessie op dezelfde computer te maken, maar wordt de toegang voor externe gebruikers geweigerd.
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 Extern.

Andere cmdlets kunnen de waarde van deze parameter later overschrijven. De cmdlet staat bijvoorbeeld Enable-PSRemoting externe toegang tot alle sessieconfiguraties toe, 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 op van het assemblybestand (*.dll) 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 op 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 wordt gebruikt voor deze configuratie. Het type dat u opgeeft, moet de klasse System.Management.Automation.Remoting.PSSessionConfiguration implementeren.

Als u het assemblybestand (*.dll) wilt opgeven waarmee het configuratietype wordt geïmplementeerd, geeft u de parameters AssemblyName en ApplicationBase op.

Door een type te maken, kunt u meer aspecten van de sessieconfiguratie beheren, zoals het weergeven of verbergen van bepaalde parameters van cmdlets, of het instellen van limieten voor gegevensgrootte en objectgrootte die gebruikers niet kunnen negeren.

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 van kracht.

Geef de parameter NoServiceRestart op om opnieuw opstarten te voorkomen en de prompt voor opnieuw opstarten te onderdrukken.

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 naar deze computer kan worden verzonden in een enkele externe opdracht. Voer de gegevensgrootte in megabytes (MB) in. De standaardwaarde is 50 MB.

Als een limiet voor de gegevensgrootte 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:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumReceivedObjectSizeMB

Hiermee geeft u een limiet voor de hoeveelheid gegevens die naar deze computer kan worden verzonden in een enkel object. 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 worden uitgesloten, kunt u gebruiken Import-Module om modules toe te voegen aan de sessie.

De modules die in deze parameterwaarde zijn opgegeven, worden geïmporteerd in aanvulling op modules die zijn opgegeven door de parameter SessionType en de 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 zijn geëxporteerd of voorkomen dat gebruikers deze 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 en onderdrukt de prompt om de service opnieuw te starten.

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

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

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 bestand 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 die als host fungeert voor de sessieconfiguratie.

U kunt deze parameter gebruiken om een 32-bits sessie te maken op een 64-bits computer. Pogingen om een 64-bits proces op een 32-bits computer te maken, 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 de machtiging Uitvoeren (Aanroepen) voor de configuratie hebben.

Als de security descriptor complex is, kunt u de parameter ShowSecurityDescriptorUI gebruiken in plaats van deze parameter. U kunt niet beide parameters in dezelfde opdracht gebruiken.

Als u deze parameter weglaat, wordt de sddl-hoofdmap voor de WinRM-service gebruikt voor deze configuratie. Gebruik de WSMan-provider om de hoofd-SDDL 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

-SessionTypeOption

Hiermee geeft u typespecifieke opties voor de sessieconfiguratie op. 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 sessieconfiguratieopties. 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. Sessieoptiewaarden 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.

Houd er bij het instellen van de machtigingen voor de configuratie rekening mee dat gebruikers ten minste de machtiging Uitvoeren (Aanroepen) moeten hebben om de sessieconfiguratie in een sessie te gebruiken.

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

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 status van de schroefdraadmodule die moet worden gebruikt. Acceptabele waarden zijn:

Onbekend
MTA
STA

Type:	ApartmentState
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:

Standaard
ReuseThread
UseCurrentThread
UseNewThread

De standaardwaarde is UseCurrentThread.

Zie PSThreadOptions Enumeration 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 op.

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 gebruiken. Standaard wordt elke sessie in een eigen proces gehost.

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 doorspezen naar deze cmdlet.

Uitvoerwaarden

WSManConfigContainerElement

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.

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

Deze cmdlet genereert XML die een configuratie van een Web Services for Management-invoegtoepassing (WS-Management) vertegenwoordigt en verzendt de XML naar WS-Management, waarmee de invoegtoepassing op de lokale computer () wordt geregistreerd.New-Item wsman:\localhost\plugin

De eigenschappen van een sessieconfiguratieobject variëren afhankelijk van de opties die zijn ingesteld voor de sessieconfiguratie en de waarden van deze opties. Sessieconfiguraties die gebruikmaken van een sessieconfiguratiebestand hebben ook aanvullende eigenschappen.

Delen via

Register-PSSessionConfiguration

Syntax

Description

Voorbeelden

Voorbeeld 1: Een NewShell-sessieconfiguratie 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

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

Invoerwaarden

Uitvoerwaarden

Notities

Aanvullende resources

Delen via

Register-PSSessionConfiguration

Syntax

Description

Voorbeelden

Voorbeeld 1: Een NewShell-sessieconfiguratie 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

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

Invoerwaarden

Uitvoerwaarden

Notities

Verwante koppelingen

Aanvullende resources