Change public API mention of monad to PowerShell (#18491)

* Change public API mention of `monad` to PowerShell

* looks like I forgot to save changes in some files
This commit is contained in:
Steve Lee
2022-11-14 12:45:23 -05:00
committed by GitHub
parent b84652745c
commit c740a07e10
29 changed files with 54 additions and 65 deletions
@@ -1075,7 +1075,7 @@ namespace Microsoft.PowerShell.Commands
#region NewPSDriveCommand
/// <summary>
/// Mounts a drive in the Monad namespace.
/// Mounts a drive in PowerShell runspace.
/// </summary>
[Cmdlet(VerbsCommon.New, "PSDrive", SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact.Low,
SupportsTransactions = true, HelpUri = "https://go.microsoft.com/fwlink/?LinkID=2096815")]
@@ -1477,7 +1477,7 @@ namespace Microsoft.PowerShell.Commands
#region RemovePSDriveCommand
/// <summary>
/// Removes a drive that is mounted in the Monad namespace.
/// Removes a drive that is mounted in the PowerShell runspace.
/// </summary>
[Cmdlet(VerbsCommon.Remove, "PSDrive", DefaultParameterSetName = NameParameterSet, SupportsShouldProcess = true, SupportsTransactions = true,
HelpUri = "https://go.microsoft.com/fwlink/?LinkID=2097050")]
@@ -1653,7 +1653,7 @@ namespace Microsoft.PowerShell.Commands
#region GetPSDriveCommand
/// <summary>
/// Gets a specified or listing of drives that are mounted in the Monad
/// Gets a specified or listing of drives that are mounted in PowerShell
/// namespace.
/// </summary>
[Cmdlet(VerbsCommon.Get, "PSDrive", DefaultParameterSetName = NameParameterSet, SupportsTransactions = true, HelpUri = "https://go.microsoft.com/fwlink/?LinkID=2096494")]
@@ -8,9 +8,7 @@ namespace Microsoft.PowerShell
{
/// <summary>
/// PSUtilityPSSnapIn is a class for facilitating registry
/// of necessary information for monad utility PSSnapin.
///
/// This class will be built with monad utility dll.
/// of necessary information for PowerShell utility PSSnapin.
/// </summary>
[RunInstaller(true)]
public sealed class PSUtilityPSSnapIn : PSSnapIn
@@ -12,10 +12,7 @@ namespace Microsoft.PowerShell
{
/// <summary>
/// EngineInstaller is a class for facilitating registry of necessary
/// information for monad engine.
///
/// This class will be built with monad console host dll
/// (System.Management.Automation.dll).
/// information for PowerShell engine.
///
/// At install time, installation utilities (like InstallUtil.exe) will
/// call install this engine assembly based on the implementation in
@@ -8,10 +8,7 @@ namespace Microsoft.PowerShell
{
/// <summary>
/// PSHostPSSnapIn is a class for facilitating registry
/// of necessary information for monad host PSSnapin.
///
/// This class will be built with monad host engine dll
/// (Microsoft.PowerShell.ConsoleHost.dll).
/// of necessary information for PowerShell host PSSnapin.
/// </summary>
[RunInstaller(true)]
public sealed class PSHostPSSnapIn : PSSnapIn
@@ -17,9 +17,7 @@ namespace Microsoft.PowerShell
{
/// <summary>
/// PSSecurityPSSnapIn is a class for facilitating registry
/// of necessary information for monad security PSSnapin.
///
/// This class will be built with monad security dll.
/// of necessary information for PowerShell security PSSnapin.
/// </summary>
[RunInstaller(true)]
public sealed class PSSecurityPSSnapIn : PSSnapIn
@@ -8,7 +8,7 @@ using System.Diagnostics;
namespace System.Management.Automation
{
/// <summary>
/// Provides information for applications that are not directly executable by Monad.
/// Provides information for applications that are not directly executable by PowerShell.
/// </summary>
/// <remarks>
/// An application is any file that is executable by Windows either directly or through
@@ -18,7 +18,7 @@ using System.Security.Permissions;
namespace System.Management.Automation
{
/// <summary>
/// Errors reported by Monad will be in one of these categories.
/// Errors reported by PowerShell will be in one of these categories.
/// </summary>
/// <remarks>
/// Do not specify ErrorCategory.NotSpecified when creating an
@@ -132,7 +132,7 @@ namespace System.Management.Automation
WriteError = 23,
/// <summary>
/// A non-Monad command reported an error to its STDERR pipe.
/// A native command reported an error to its STDERR pipe.
/// </summary>
/// <remarks>
/// The Engine uses this ErrorCategory when it executes a native
@@ -15,8 +15,8 @@ namespace System.Management.Automation
/// When a cmdlet is instantiated and run directly, all calls to the stream APIs will be proxied
/// through to an instance of this class. For example, when a cmdlet calls WriteObject, the
/// WriteObject implementation on the instance of the class implementing this interface will be
/// called. The Monad implementation provides a default implementation of this class for use with
/// standalone cmdlets as well as the implementation provided for running in the monad engine itself.
/// called. PowerShell implementation provides a default implementation of this class for use with
/// standalone cmdlets as well as the implementation provided for running in the engine itself.
///
/// If you do want to run Cmdlet instances standalone and capture their output with more
/// fidelity than is provided for with the default implementation, then you should create your own
@@ -174,7 +174,7 @@ namespace System.Management.Automation
/// pipeline execution log.
///
/// If LogPipelineExecutionDetail is turned on, this information will be written
/// to monad log under log category "Pipeline execution detail"
/// to PowerShell log under log category "Pipeline execution detail"
/// </remarks>
/// <seealso cref="System.Management.Automation.ICommandRuntime.WriteDebug(string)"/>
/// <seealso cref="System.Management.Automation.ICommandRuntime.WriteVerbose(string)"/>
@@ -876,7 +876,7 @@ namespace System.Management.Automation
/// pipeline execution log.
///
/// If LogPipelineExecutionDetail is turned on, this information will be written
/// to monad log under log category "Pipeline execution detail"
/// to PowerShell log under log category "Pipeline execution detail"
/// </remarks>
/// <seealso cref="System.Management.Automation.ICommandRuntime.WriteDebug(string)"/>
/// <seealso cref="System.Management.Automation.ICommandRuntime.WriteVerbose(string)"/>
@@ -8,7 +8,7 @@ using System.Runtime.CompilerServices;
namespace System.Management.Automation
{
/// <summary>
/// Define type for a reference object in Monad scripting language.
/// Define type for a reference object in PowerShell scripting language.
/// </summary>
/// <remarks>
/// This class is used to describe both kinds of references:
@@ -511,7 +511,7 @@ namespace System.Management.Automation
/// pipeline execution log.
///
/// If LogPipelineExecutionDetail is turned on, this information will be written
/// to monad log under log category "Pipeline execution detail"
/// to PowerShell log under log category "Pipeline execution detail"
/// </remarks>
/// <seealso cref="System.Management.Automation.Cmdlet.WriteDebug(string)"/>
/// <seealso cref="System.Management.Automation.Cmdlet.WriteVerbose(string)"/>
@@ -79,7 +79,7 @@ namespace System.Management.Automation.Host
/// </summary>
/// <remarks>
/// When implementing this member, it should return the product version number for the product
/// that is hosting the Monad engine.
/// that is hosting the PowerShell engine.
/// </remarks>
/// <value>
/// The version number of the hosting application.
@@ -6628,7 +6628,6 @@ namespace Microsoft.PowerShell
/// - PropertySerializationSet=<empty>
/// - TargetTypeForDeserialization=DeserializingTypeConverter
/// - Add a field of that type in unit tests / S.M.A.Test.SerializationTest+RehydratedType
/// (testsrc\admintest\monad\DRT\engine\UnitTests\SerializationTest.cs)
/// -->
public sealed class DeserializingTypeConverter : PSTypeConverter
{
@@ -12,11 +12,11 @@ namespace System.Management.Automation.Provider
/// </summary>
/// <remarks>
/// The ItemCmdletProvider class is a base class that a provider derives from to
/// inherit a set of methods that allows the Monad engine
/// inherit a set of methods that allows the PowerShell engine
/// to provide a core set of commands for getting and setting of data on one or
/// more items. A provider should derive from this class if they want
/// to take advantage of the item core commands that are
/// already implemented by the Monad engine. This allows users to have common
/// already implemented by the engine. This allows users to have common
/// commands and semantics across multiple providers.
/// </remarks>
public abstract class ItemCmdletProvider : DriveCmdletProvider
@@ -77,30 +77,30 @@ namespace System.Management.Automation.Provider
{
/// <summary>
/// The provider does not add any additional capabilities beyond what the
/// Monad engine provides.
/// PowerShell engine provides.
/// </summary>
None = 0x0,
/// <summary>
/// The provider does the inclusion filtering for those commands that take an Include
/// parameter. The Monad engine should not try to do the filtering on behalf of this
/// parameter. The PowerShell engine should not try to do the filtering on behalf of this
/// provider.
/// </summary>
/// <remarks>
/// Note, the provider should make every effort to filter in a way that is consistent
/// with the Monad engine. This option is allowed because in many cases the provider
/// with the PowerShell engine. This option is allowed because in many cases the provider
/// can be much more efficient at filtering.
/// </remarks>
Include = 0x1,
/// <summary>
/// The provider does the exclusion filtering for those commands that take an Exclude
/// parameter. The Monad engine should not try to do the filtering on behalf of this
/// parameter. The PowerShell engine should not try to do the filtering on behalf of this
/// provider.
/// </summary>
/// <remarks>
/// Note, the provider should make every effort to filter in a way that is consistent
/// with the Monad engine. This option is allowed because in many cases the provider
/// with the PowerShell engine. This option is allowed because in many cases the provider
/// can be much more efficient at filtering.
/// </remarks>
Exclude = 0x2,
@@ -111,18 +111,18 @@ namespace System.Management.Automation.Provider
/// <remarks>
/// When this attribute is specified a provider specific filter can be passed from
/// the Core Commands to the provider. This filter string is not interpreted in any
/// way by the Monad engine.
/// way by the PowerShell engine.
/// </remarks>
Filter = 0x4,
/// <summary>
/// The provider does the wildcard matching for those commands that allow for it. The Monad
/// The provider does the wildcard matching for those commands that allow for it. The PowerShell
/// engine should not try to do the wildcard matching on behalf of the provider when this
/// flag is set.
/// </summary>
/// <remarks>
/// Note, the provider should make every effort to do the wildcard matching in a way that is consistent
/// with the Monad engine. This option is allowed because in many cases wildcard matching
/// with the PowerShell engine. This option is allowed because in many cases wildcard matching
/// cannot occur via the path name or because the provider can do the matching in a much more
/// efficient manner.
/// </remarks>
@@ -19,7 +19,7 @@ namespace Microsoft.PowerShell
{
/// <summary>
/// Defines the authorization policy that controls the way scripts
/// (and other command types) are handled by Monad. This authorization
/// (and other command types) are handled by PowerShell. This authorization
/// policy enforces one of four levels, as defined by the 'ExecutionPolicy'
/// value in one of the following locations:
///
@@ -40,14 +40,14 @@ namespace Microsoft.PowerShell
/// signed, and by a trusted publisher. If you haven't made a trust decision
/// on the publisher yet, prompting is done as in AllSigned mode.
/// AllSigned - All .ps1 and .ps1xml files must be digitally signed. If
/// signed and executed, Monad prompts to determine if files from the
/// signed and executed, PowerShell prompts to determine if files from the
/// signing publisher should be run or not.
/// RemoteSigned - Only .ps1 and .ps1xml files originating from the internet
/// must be digitally signed. If remote, signed, and executed, Monad
/// must be digitally signed. If remote, signed, and executed, PowerShell
/// prompts to determine if files from the signing publisher should be
/// run or not. This is the default setting.
/// Unrestricted - No files must be signed. If a file originates from the
/// internet, Monad provides a warning prompt to alert the user. To
/// internet, PowerShell provides a warning prompt to alert the user. To
/// suppress this warning message, right-click on the file in File Explorer,
/// select "Properties," and then "Unblock." Requires Shell.
/// Bypass - No files must be signed, and internet origin is not verified.
@@ -32,19 +32,19 @@ namespace Microsoft.PowerShell
public enum ExecutionPolicy
{
/// Unrestricted - No files must be signed. If a file originates from the
/// internet, Monad provides a warning prompt to alert the user. To
/// internet, PowerShell provides a warning prompt to alert the user. To
/// suppress this warning message, right-click on the file in File Explorer,
/// select "Properties," and then "Unblock."
Unrestricted = 0,
/// RemoteSigned - Only .ps1 and .ps1xml files originating from the internet
/// must be digitally signed. If remote, signed, and executed, Monad
/// must be digitally signed. If remote, signed, and executed, PowerShell
/// prompts to determine if files from the signing publisher should be
/// run or not. This is the default setting.
RemoteSigned = 1,
/// AllSigned - All .ps1 and .ps1xml files must be digitally signed. If
/// signed and executed, Monad prompts to determine if files from the
/// signed and executed, PowerShell prompts to determine if files from the
/// signing publisher should be run or not.
AllSigned = 2,
@@ -231,7 +231,7 @@ namespace System.Management.Automation
}
/// <summary>
/// Monad version used by PSSnapin.
/// PowerShell version used by PSSnapin.
/// </summary>
public Version PSVersion { get; }
@@ -307,13 +307,13 @@ namespace System.Management.Automation
/// user hitting CTRL-C, or by a call to
/// <see cref="System.Management.Automation.Runspaces.Pipeline.Stop"/>.
///
/// When a cmdlet or provider sees this exception thrown from a Monad API such as
/// When a cmdlet or provider sees this exception thrown from a PowerShell API such as
/// WriteObject(object)
/// this means that the command was already stopped. The cmdlet or provider
/// should clean up and return.
/// Catching this exception is optional; if the cmdlet or providers chooses not to
/// handle PipelineStoppedException and instead allow it to propagate to the
/// Monad Engine's call to ProcessRecord, the Monad Engine will handle it properly.
/// PowerShell Engine's call to ProcessRecord, the PowerShell Engine will handle it properly.
/// </remarks>
[Serializable]
public class PipelineStoppedException : RuntimeException
@@ -616,13 +616,13 @@ namespace System.Management.Automation
#region ParentContainsErrorRecordException
/// <summary>
/// ParentContainsErrorRecordException is the exception contained by the ErrorRecord
/// which is associated with a Monad engine custom exception through
/// which is associated with a PowerShell engine custom exception through
/// the IContainsErrorRecord interface.
/// </summary>
/// <remarks>
/// We use this exception class
/// so that there is not a recursive "containment" relationship
/// between the Monad engine exception and its ErrorRecord.
/// between the PowerShell engine exception and its ErrorRecord.
/// </remarks>
[Serializable]
public class ParentContainsErrorRecordException : SystemException
@@ -808,8 +808,8 @@ namespace System.Management.Automation
/// exceeds the configured maximum.
/// </summary>
/// <remarks>
/// When one Monad command or script calls another, this creates an additional
/// scope. Some script expressions also create a scope. Monad imposes a maximum
/// When one PowerShell command or script calls another, this creates an additional
/// scope. Some script expressions also create a scope. PowerShell imposes a maximum
/// call depth to prevent stack overflows. The maximum call depth is configurable
/// but generally high enough that scripts which are not deeply recursive
/// should not have a problem.
@@ -13,7 +13,7 @@ namespace System.Management.Automation
/// </summary>
/// <remarks>
/// Instances of this exception class are usually generated by the
/// Monad Engine. It is unusual for code outside the Monad Engine
/// PowerShell Engine. It is unusual for code outside the PowerShell Engine
/// to create an instance of this class.
/// </remarks>
[Serializable]
@@ -13,7 +13,7 @@ namespace System.Management.Automation
/// </summary>
/// <remarks>
/// Instances of this exception class are usually generated by the
/// Monad Engine. It is unusual for code outside the Monad Engine
/// PowerShell Engine. It is unusual for code outside the PowerShell Engine
/// to create an instance of this class.
/// </remarks>
[Serializable]
@@ -13,7 +13,7 @@ namespace System.Management.Automation
/// </summary>
/// <remarks>
/// Instances of this exception class are usually generated by the
/// Monad Engine. It is unusual for code outside the Monad Engine
/// PowerShell Engine. It is unusual for code outside the PowerShell Engine
/// to create an instance of this class.
/// </remarks>
[Serializable]
@@ -13,7 +13,7 @@ namespace System.Management.Automation
/// </summary>
/// <remarks>
/// Instances of this exception class are usually generated by the
/// Monad Engine. It is unusual for code outside the Monad Engine
/// PowerShell Engine. It is unusual for code outside the PowerShell Engine
/// to create an instance of this class.
/// </remarks>
[Serializable]
@@ -13,7 +13,7 @@ namespace System.Management.Automation
/// </summary>
/// <remarks>
/// Instances of this exception class are usually generated by the
/// Monad Engine. It is unusual for code outside the Monad Engine
/// PowerShell Engine. It is unusual for code outside the PowerShell Engine
/// to create an instance of this class.
/// </remarks>
[Serializable]
@@ -13,7 +13,7 @@ namespace System.Management.Automation
/// </summary>
/// <remarks>
/// Instances of this exception class are usually generated by the
/// Monad Engine. It is unusual for code outside the Monad Engine
/// PowerShell Engine. It is unusual for code outside the PowerShell Engine
/// to create an instance of this class.
/// </remarks>
[Serializable]
@@ -13,7 +13,7 @@ namespace System.Management.Automation
/// </summary>
/// <remarks>
/// Instances of this exception class are usually generated by the
/// Monad Engine. It is unusual for code outside the Monad Engine
/// PowerShell Engine. It is unusual for code outside the PowerShell Engine
/// to create an instance of this class.
/// </remarks>
[Serializable]
@@ -10,14 +10,14 @@ namespace System.Management.Automation
{
/// <summary>
/// An PSTraceSource is a representation of a System.Diagnostics.TraceSource instance
/// that is used in the Monad components to produce trace output.
/// that is used in the PowerShell components to produce trace output.
/// </summary>
/// <remarks>
/// It is permitted to subclass <see cref="PSTraceSource"/>
/// but there is no established scenario for doing this, nor has it been tested.
/// </remarks>
/// <!--
/// IF YOU ARE NOT PART OF THE MONAD DEVELOPMENT TEAM PLEASE
/// IF YOU ARE NOT PART OF THE PowerShell DEVELOPMENT TEAM PLEASE
/// DO NOT USE THIS CLASS!!!!!
///
/// The PSTraceSource class is derived from Switch to provide granular
@@ -8,14 +8,14 @@ namespace System.Management.Automation
{
/// <summary>
/// RuntimeException is the base class for exceptions likely to occur
/// while a Monad command is running.
/// while a PowerShell command is running.
/// </summary>
/// <remarks>
/// Monad scripts can trap RuntimeException using the
/// PowerShell scripts can trap RuntimeException using the
/// "trap (exceptionclass) {handler}" script construct.
///
/// Instances of this exception class are usually generated by the
/// Monad Engine. It is unusual for code outside the Monad Engine
/// PowerShell Engine. It is unusual for code outside the PowerShell Engine
/// to create an instance of this class.
/// </remarks>
[Serializable]
@@ -216,7 +216,7 @@ namespace System.Management.Automation
/// <summary>
/// An PSTraceSource is a representation of a System.Diagnostics.TraceSource instance
/// that is used in the Monad components to produce trace output.
/// that is used in the PowerShell components to produce trace output.
/// </summary>
/// <!--
/// The StructuredTraceSource class is derived from TraceSource to provide granular