PowerShell ConvertTo-SecureString-Syntax

Question

Ich habe ein Problem mit der Syntax des Cmdlets ConvertTo-SecureString. Aus der Hilfe: ConvertTo-SecureString [-String] <String> [[-AsPlainText]] [[-Force]] [<CommonParameters>]. Die einzelne eckige Klammer bedeutet: ein optionaler Parameter, richtig? Und die doppelten eckigen Klammern um -AsPlainText und -Force? Danke für Ihre Hilfe Purclot Avignon

Answer 1

Nein, Sie haben es falsch verstanden. [-String] <String> ist kein optionaler Parameter, sondern ein erforderlicher Parameter. [-AsPlainText] und [-Force] sind beide optionale Parameter.

Siehe Dokumentation ConvertTo-SecureString speziell die Parameters Abschnitt und in diesem sehen Sie den Wert Required? Attribut.

Answer 2

Das bedeutet, dass AsPlainText und Force optionale Positionsschalterparameter sind. So kann man es so nennen:

ConvertTo-SecureString 'Password' -AsPlainText -Force 

wie folgt aus:

ConvertTo-SecureString 'Password' $true $true 

oder so:

ConvertTo-SecureString ${Value from ConvertFrom-SecureString command} 

Parameterdefinition für die obligatorische benannten Parameter wie folgt aussehen:

-ParameterName <ParameterType> 

Wenn der Parameter opt ional, die eckigen Klammern um sie fügt hinzu:

[-ParameterName <ParameterType>] 

Wenn der Parameter Positions ist (Parametername optional), die eckigen Klammern um Parameternamen ergänzt:

[-ParameterName] <ParameterType> 

Wenn Parameterschalter-Parameter ist, das entfernt <ParameterType> Teil:

-ParameterName 

Also, wenn Sie optionale Positionsschalter Parameter haben es wie folgt (zwei eckigen Klammern würde und keineTeil):

[[-ParameterName]] 

Und es kommt vor, dass verbindliche Positionsschalter Parameter und optional benannte Schalter Parameter beide wie folgt aussehen: