From 44831b8888a06650ebc0963c919a058e37db2d28 Mon Sep 17 00:00:00 2001 From: Sean Wheeler Date: Thu, 12 Oct 2023 18:40:37 -0500 Subject: [PATCH] Remove plural parameter name example (#10518) --- .../developer/cmdlet/security-parameters.md | 65 ++++++++++--------- 1 file changed, 35 insertions(+), 30 deletions(-) diff --git a/reference/docs-conceptual/developer/cmdlet/security-parameters.md b/reference/docs-conceptual/developer/cmdlet/security-parameters.md index 2885c16fc3cd..1620b7112447 100644 --- a/reference/docs-conceptual/developer/cmdlet/security-parameters.md +++ b/reference/docs-conceptual/developer/cmdlet/security-parameters.md @@ -8,38 +8,43 @@ title: Security Parameters The following table lists the recommended names and functionality for parameters used to provide security information for an operation, such as parameters that specify certificate key and privilege information. -|Parameter|Functionality| -|---|---| -|**ACL**
Data type: String|Implement this parameter to specify the access control level of protection for a catalog or for a Uniform Resource Identifier (URI).| -|**CertFile**
Data type: String|Implement this parameter so that the user can specify the name of a file that contains one of the following:
- A Base64 or Distinguished Encoding Rules (DER) encoded x.509 certificate
- A Public Key Cryptography Standards (PKCS) #12 file that contains at least one certificate and key| -|**CertIssuerName**
Data type: String|Implement this parameter so that the user can specify the name of the issuer of a certificate or so that the user can specify a substring.| -|**CertRequestFile**
Data type: String|Implement this parameter to specify the name of a file that contains a Base64 or DER-encoded PKCS #10 certificate request.| -|**CertSerialNumber**
Data type: String|Implement this parameter to specify the serial number that was issued by the certification authority.| -|**CertStoreLocation**
Data type: String|Implement this parameter so that the user can specify the location of the certificate store. The location is typically a file path.| -|**CertSubjectName**
Data type: String|Implement this parameter so that the user can specify the issuer of a certificate or so that the user can specify a substring.| -|**CertUsage**
Data type: String|Implement this parameter to specify the key usage or the enhanced key usage. The key can be represented as a bit mask, a bit, an object identifier (OID), or a string.| -|**Credential**
Data type: [System.Management.Automation.PSCredential](/dotnet/api/System.Management.Automation.PSCredential)|Implement this parameter so that the cmdlet will automatically prompt the user for a user name or password. A prompt for both is displayed if a full credential is not supplied directly.| -|**CSPName**
Data type: String|Implement this parameter so that the user can specify the name of the certificate service provider (CSP).| -|**CSPType**
Data type: Integer|Implement this parameter so that the user can specify the type of CSP.| -|**Group**
Data type: String|Implement this parameter so that the user can specify a collection of principals for access. For more information, see the description of the **Principal** parameter.| -|**KeyAlgorithm**
Data type: String|Implement this parameter so that the user can specify the key generation algorithm to use for security.| -|**KeyContainerName**
Data type: String|Implement this parameter so that the user can specify the name of the key container.| -|**KeyLength**
Data type: Integer|Implement this parameter so that the user can specify the length of the key in bits.| -|**Operation**
Data type: String|Implement this parameter so that the user can specify an action that can be performed on a protected object.| -|**Principal**
Data type: String|Implement this parameter so that the user can specify a unique identifiable entity for access.| -|**Privilege**
Data type: String|Implement this parameter so that the user can specify the right a cmdlet needs to perform an operation for a particular entity.| -|**Privileges**
Data type: Array of privileges|Implement this parameter so that the user can specify the rights that a cmdlet needs to perform its operation for a particular entry.| -|**Role**
Data type: String|Implement this parameter so that the user can specify a set of operations that can be performed by an entity.| -|**SaveCred**
Data type: SwitchParameter|Implement this parameter so that credentials that were previously saved by the user will be used when the parameter is specified.| -|**Scope**
Data type: String|Implement this parameter so that the user can specify the group of protected objects for the cmdlet.| -|**SID**
Data type: String|Implement this parameter so that the user can specify a unique identifier that represents a principal.| -|**Trusted**
Data type: SwitchParameter|Implement this parameter so that trust levels are supported when the parameter is specified.| -|**TrustLevel**
Data type: Keyword|Implement this parameter so that the user can specify the trust level that is supported. For example, possible values include internet, intranet, and fulltrust.| +| Parameter | Functionality | +| ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **ACL**
Data type: String | Implement this parameter to specify the access control level of protection for a catalog or for a Uniform Resource Identifier (URI). | +| **CertFile**
Data type: String | Implement this parameter so that the user can specify the name of a file that contains one of the following:
- A Base64 or Distinguished Encoding Rules (DER) encoded x.509 certificate
- A Public Key Cryptography Standards (PKCS) #12 file that contains at least one certificate and key | +| **CertIssuerName**
Data type: String | Implement this parameter so that the user can specify the name of the issuer of a certificate or so that the user can specify a substring. | +| **CertRequestFile**
Data type: String | Implement this parameter to specify the name of a file that contains a Base64 or DER-encoded PKCS #10 certificate request. | +| **CertSerialNumber**
Data type: String | Implement this parameter to specify the serial number that was issued by the certification authority. | +| **CertStoreLocation**
Data type: String | Implement this parameter so that the user can specify the location of the certificate store. The location is typically a file path. | +| **CertSubjectName**
Data type: String | Implement this parameter so that the user can specify the issuer of a certificate or so that the user can specify a substring. | +| **CertUsage**
Data type: String | Implement this parameter to specify the key usage or the enhanced key usage. The key can be represented as a bit mask, a bit, an object identifier (OID), or a string. | +| **Credential**
Data type: [System.Management.Automation.PSCredential][04] | Implement this parameter so that the cmdlet will automatically prompt the user for a user name or password. A prompt for both is displayed if a full credential is not supplied directly. | +| **CSPName**
Data type: String | Implement this parameter so that the user can specify the name of the certificate service provider (CSP). | +| **CSPType**
Data type: Integer | Implement this parameter so that the user can specify the type of CSP. | +| **Group**
Data type: String | Implement this parameter so that the user can specify a collection of principals for access. For more information, see the description of the **Principal** parameter. | +| **KeyAlgorithm**
Data type: String | Implement this parameter so that the user can specify the key generation algorithm to use for security. | +| **KeyContainerName**
Data type: String | Implement this parameter so that the user can specify the name of the key container. | +| **KeyLength**
Data type: Integer | Implement this parameter so that the user can specify the length of the key in bits. | +| **Operation**
Data type: String | Implement this parameter so that the user can specify an action that can be performed on a protected object. | +| **Principal**
Data type: String | Implement this parameter so that the user can specify a unique identifiable entity for access. | +| **Privilege**
Data type: String, String[] | Implement this parameter so that the user can specify the rights a cmdlet needs to perform an operation for a particular entity. | +| **Role**
Data type: String | Implement this parameter so that the user can specify a set of operations that can be performed by an entity. | +| **SaveCred**
Data type: SwitchParameter | Implement this parameter so that credentials that were previously saved by the user will be used when the parameter is specified. | +| **Scope**
Data type: String | Implement this parameter so that the user can specify the group of protected objects for the cmdlet. | +| **SID**
Data type: String | Implement this parameter so that the user can specify a unique identifier that represents a principal. | +| **Trusted**
Data type: SwitchParameter | Implement this parameter so that trust levels are supported when the parameter is specified. | +| **TrustLevel**
Data type: Keyword | Implement this parameter so that the user can specify the trust level that is supported. For example, possible values include internet, intranet, and fulltrust. | ## See Also -[Cmdlet Parameters](./cmdlet-parameters.md) +[Cmdlet Parameters][02] -[Writing a Windows PowerShell Cmdlet](./writing-a-windows-powershell-cmdlet.md) +[Writing a Windows PowerShell Cmdlet][03] -[Windows PowerShell SDK](../windows-powershell-reference.md) +[Windows PowerShell SDK][01] + + +[01]: ../windows-powershell-reference.md +[02]: ./cmdlet-parameters.md +[03]: ./writing-a-windows-powershell-cmdlet.md +[04]: /dotnet/api/System.Management.Automation.PSCredential