ImpliedReflection

1.0.0

en-US/ImpliedReflection-help.xml

                                <?xml version="1.0" encoding="utf-8"?>

<helpItems schema="maml" xmlns="http://msh">

  <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">

    <command:details>

      <command:name>Enable-ImpliedReflection</command:name>

      <command:verb>Enable</command:verb>

      <command:noun>ImpliedReflection</command:noun>

      <maml:description>

        <maml:para>Enable the binding of non-public members to all objects outputted.</maml:para>

      </maml:description>

    </command:details>

    <maml:description>

      <maml:para>The Enable-ImpliedReflection cmdlet injects hooks into the PowerShell engine to force non-public and unsupported members and types to function as though they were public. This operation is global to the process and is not reversible.</maml:para>

    </maml:description>

    <command:syntax>

      <command:syntaxItem>

        <maml:name>Enable-ImpliedReflection</maml:name>

        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">

          <maml:name>Force</maml:name>

          <maml:Description>

            <maml:para>If specified, this function will not prompt for confirmation before enabling implied reflection.</maml:para>

          </maml:Description>

          <dev:type>

            <maml:name>SwitchParameter</maml:name>

            <maml:uri />

          </dev:type>

          <dev:defaultValue>False</dev:defaultValue>

        </command:parameter>

      </command:syntaxItem>

    </command:syntax>

    <command:parameters>

      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">

        <maml:name>Force</maml:name>

        <maml:Description>

          <maml:para>If specified, this function will not prompt for confirmation before enabling implied reflection.</maml:para>

        </maml:Description>

        <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue>

        <dev:type>

          <maml:name>SwitchParameter</maml:name>

          <maml:uri />

        </dev:type>

        <dev:defaultValue>False</dev:defaultValue>

      </command:parameter>

    </command:parameters>

    <command:inputTypes>

      <command:inputType>

        <dev:type>

          <maml:name>None</maml:name>

        </dev:type>

        <maml:description>

          <maml:para>This function does not accept input from the pipeline.</maml:para>

        </maml:description>

      </command:inputType>

    </command:inputTypes>

    <command:returnValues>

      <command:returnValue>

        <dev:type>

          <maml:name>None</maml:name>

        </dev:type>

        <maml:description>

          <maml:para>This function does not output to the pipeline.</maml:para>

        </maml:description>

      </command:returnValue>

    </command:returnValues>

    <maml:alertSet>

      <maml:alert>

        <maml:para></maml:para>

      </maml:alert>

    </maml:alertSet>

    <command:examples>

      <command:example>

        <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title>

        <dev:code>using namespace System.Management.Automation

Enable-ImpliedReflection -YesIKnowIShouldNotDoThis

$sbd = [CompiledScriptBlockData]::new(

    '"hi!"',

    $false)

$sb = [scriptblock]::new($sbd)

$optimized = $true

$action = $sb.GetCodeToInvoke([ref] $optimized, [ScriptBlockClauseToInvoke]::End)

$scope = $null

try {

    $locals = $sb.MakeLocalsTuple($true)

    $scope = $ExecutionContext._context.EngineSessionState.NewScope($false)

    $scope.LocalsTuple = $locals

    $locals.SetAutomaticVariable(

        [AutomaticVariable]::MyInvocation,

        $MyInvocation,

        $ExecutionContext._context)

    $context = [Language.FunctionContext]@{

        _executionContext = $ExecutionContext._context

        _outputPipe = $ExecutionContext._context.CurrentCommandProcessor.CommandRuntime.OutputPipe

        _localsTuple = $scope.LocalsTuple

        _scriptBlock = $sb

        _file = $null

        _debuggerHidden = $false

        _debuggerStepThrough = $false

        _sequencePoints = $sbd.SequencePoints

    }

    $Host.Runspace.Debugger.EnterScriptFunction($context)

    $action.Invoke($context)

} finally {

    if ($null -ne $scope) {

        $ExecutionContext._context.EngineSessionState.RemoveScope($scope)

    }

}</dev:code>

        <dev:remarks>

          <maml:para>Goes the long way around to invoke a scriptblock of `"hi!"`. There's no point to do this, but it shows off all the different things that work with ImpliedReflection.</maml:para>

        </dev:remarks>

      </command:example>

      <command:example>

        <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title>

        <dev:code>Enable-ImpliedReflection -YesIKnowIShouldNotDoThis

$ExecutionContext._context

    CurrentExceptionBeingHandled                                  :

    PropagateExceptionsToEnclosingStatementBlock                  : True

    QuestionMarkVariableValue                                     : True

    LanguageMode                                                  : FullLanguage

    EngineIntrinsics                                              : System.Management.Automation.EngineIntrinsics

    ShellFunctionErrorOutputPipe                                  : System.Management.Automation.Internal.Pipe

    TypeTable                                                     : System.Management.Automation.Runspaces.TypeTable

    ExpressionWarningOutputPipe                                   :

    ExpressionVerboseOutputPipe                                   :

    ExpressionDebugOutputPipe                                     :

    ExpressionInformationOutputPipe                               :

    Events                                                        : System.Management.Automation.PSLocalEventManager

    Debugger                                                      : System.Management.Automation.ScriptDebugger

    PSDebugTraceLevel                                             : 0

    PSDebugTraceStep                                              : False

    ShouldTraceStatement                                          : False

    ScriptCommandProcessorShouldRethrowExit                       : False

    IgnoreScriptDebug                                             : False

    Engine                                                        : System.Management.Automation.AutomationEngine

    RunspaceConfiguration                                         :

    InitialSessionState                                           : System.Management.Automation.Runspaces.InitialSessionSt

                                                                    ate

    IsSingleShell                                                 : True

    PreviousModuleProcessed                                       :

    ModuleBeingProcessed                                          :

    AppDomainForModuleAnalysis                                    :

    AuthorizationManager                                          : Microsoft.PowerShell.PSAuthorizationManager

    ProviderNames                                                 : System.Management.Automation.SingleShellProviderNames

    Modules                                                       : System.Management.Automation.ModuleIntrinsics

    ShellID                                                       : Microsoft.PowerShell

    EngineSessionState                                            : System.Management.Automation.SessionStateInternal

    TopLevelSessionState                                          : System.Management.Automation.SessionStateInternal

    SessionState                                                  : System.Management.Automation.SessionState

    HasRunspaceEverUsedConstrainedLanguageMode                    : False

    UseFullLanguageModeInDebugger                                 : False

    IsModuleWithJobSourceAdapterLoaded                            : False

    LocationGlobber                                               : System.Management.Automation.LocationGlobber

    EngineState                                                   : Available

    HelpSystem                                                    : System.Management.Automation.HelpSystem

    FormatInfo                                                    :

    CustomArgumentCompleters                                      :

    NativeArgumentCompleters                                      :

    CurrentCommandProcessor                                       : format-default

    CommandDiscovery                                              : System.Management.Automation.CommandDiscovery

    EngineHostInterface                                           : System.Management.Automation.Internal.Host.InternalHost

    InternalHost                                                  : System.Management.Automation.Internal.Host.InternalHost

    LogContextCache                                               : System.Management.Automation.LogContextCache

    ExternalSuccessOutput                                         : System.Management.Automation.Internal.ObjectWriter

    ExternalErrorOutput                                           : System.Management.Automation.Internal.ObjectWriter

    ExternalProgressOutput                                        :

    CurrentRunspace                                               : System.Management.Automation.Runspaces.LocalRunspace

    CurrentPipelineStopping                                       : False

    DebugPreferenceVariable                                       : SilentlyContinue

    VerbosePreferenceVariable                                     : SilentlyContinue

    ErrorActionPreferenceVariable                                 : Continue

    WarningActionPreferenceVariable                               : Continue

    InformationActionPreferenceVariable                           : SilentlyContinue

    WhatIfPreferenceVariable                                      : False

    ConfirmPreferenceVariable                                     : High

    FormatDBManager                                               : Microsoft.PowerShell.Commands.Internal.Format.TypeInfoD

                                                                    ataBaseManager

    TransactionManager                                            : System.Management.Automation.Internal.PSTransactionMana

                                                                    ger

    _debugger                                                     : System.Management.Automation.ScriptDebugger

    _debuggingMode                                                : 0

    eventManager                                                  : System.Management.Automation.PSLocalEventManager

    debugTraceLevel                                               : 0

    debugTraceStep                                                : False

    _scriptCommandProcessorShouldRethrowExit                      : False

    _engine                                                       : System.Management.Automation.AutomationEngine

    _runspaceConfiguration                                        :

    _initialSessionState                                          : System.Management.Automation.Runspaces.InitialSessionSt

                                                                    ate

    _previousModuleProcessed                                      :

    _moduleBeingProcessed                                         :

    _responsibilityForModuleAnalysisAppDomainOwned                : False

    _authorizationManager                                         : Microsoft.PowerShell.PSAuthorizationManager

    _modules                                                      : System.Management.Automation.ModuleIntrinsics

    _shellId                                                      : Microsoft.PowerShell

    _languageMode                                                 : FullLanguage

    &lt;HasRunspaceEverUsedConstrainedLanguageMode&gt;k__BackingField   : False

    &lt;IsModuleWithJobSourceAdapterLoaded&gt;k__BackingField           : False

    _locationGlobber                                              : System.Management.Automation.LocationGlobber

    _engineState                                                  : Available

    _helpSystem                                                   : System.Management.Automation.HelpSystem

    _formatInfo                                                   :

    commandFactory                                                : System.Management.Automation.CommandFactory

    myHostInterface                                               : System.Management.Automation.Internal.Host.InternalHost

    _engineIntrinsics                                             : System.Management.Automation.EngineIntrinsics

    _externalErrorOutput                                          : System.Management.Automation.Internal.ObjectWriter

    _externalProgressOutput                                       :

    &lt;PropagateExceptionsToEnclosingStatementBlock&gt;k__BackingField : True

    &lt;CurrentExceptionBeingHandled&gt;k__BackingField                 :

    _questionMarkVariableValue                                    : True

    _typeTable                                                    : System.Management.Automation.Runspaces.TypeTable

    _assemblyCacheInitialized                                     : False

    _moduleNestingDepth                                           : 0

$moduleOutput = $null

$sessionState = [System.Management.Automation.SessionState]::new()

$ExecutionContext._context.Modules.CreateModule('MyModule', 'FakeModulePath', {'FakeModuleOutput'}, $sessionState, [ref]$moduleOutput, @())

    ModuleType Version    Name                                ExportedCommands

    ---------- -------    ----                                ----------------

    Script     0.0        MyModule

$moduleOutput

    FakeModuleOutput</dev:code>

        <dev:remarks>

          <maml:para>Enables implied reflection and explores the current ExecutionContext.  Then creates a module using a non-public method that allows for more control.</maml:para>

        </dev:remarks>

      </command:example>

    </command:examples>

    <command:relatedLinks>

      <maml:navigationLink>

        <maml:linkText>Online Version:</maml:linkText>

        <maml:uri>https://github.com/SeeminglyScience/ImpliedReflection/blob/master/docs/en-US/Enable-ImpliedReflection.md</maml:uri>

      </maml:navigationLink>

    </command:relatedLinks>

  </command:command>

</helpItems>