Register-PSSessionConfiguration
Hiermee maakt en registreert u een nieuwe sessieconfiguratie.
Syntaxis
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 newshell
u .
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 configuratie van de AdminShell-sessie 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.
- 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 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 |
Geaccepteerde waarden: | Disabled, Local, Remote |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 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 klasse DefaultRemotePowerShellConfiguration gebruikt voor de sessieconfiguratie.
Type: | String |
Position: | 2 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliassen: | cf |
Position: | Named |
Default value: | False |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Name
Hiermee geeft u een naam voor de sessieconfiguratie. Deze parameter is vereist.
Type: | String |
Position: | 0 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | True |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Aliassen: | PA |
Geaccepteerde waarden: | x86, amd64 |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Aliassen: | PowerShellVersion |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-SessionType
Hiermee geeft u het type sessie dat wordt gemaakt met behulp van de sessieconfiguratie. De aanvaardbare 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.
- 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-FormatData
Get-Command
,Get-Help
,Measure-Object
, , enSelect-Object
Out-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 |
Geaccepteerde waarden: | DefaultRemoteShell, Workflow |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 kunnen 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-ThreadApartmentState
Hiermee geeft u de appartementsstatus van de threadingmodule die moet worden gebruikt. Acceptabele waarden zijn:
- Onbekend
- MTA
- STA
Type: | ApartmentState |
Geaccepteerde waarden: | STA, MTA, Unknown |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Geaccepteerde waarden: | Default, UseNewThread, ReuseThread, UseCurrentThread |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-TransportOption
Hiermee geeft u de transportoptie.
Deze parameter is geïntroduceerd in PowerShell 3.0.
Type: | PSTransportOption |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliassen: | wi |
Position: | Named |
Default value: | False |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Invoerwaarden
None
U kunt geen objecten doorsluisen naar deze cmdlet.
Uitvoerwaarden
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.
Verwante koppelingen
- Disable-PSSessionConfiguration
- Enable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan Provider
- about_Session_Configurations
- about_Session_Configuration_Files