Get-Secret

الوحدة النمطية:

Microsoft.PowerShell.SecretManagement

البحث عن سر وإرجاعه بالاسم من المخازن المسجلة.

بناء الجملة

Get-Secret
   [-Name] <String>
   [[-Vault] <String>]
   [-AsPlainText]
   [<CommonParameters>]

Get-Secret
   [-InputObject] <SecretInformation>
   [-AsPlainText]
   [<CommonParameters>]

الوصف

يبحث cmdlet هذا عن السر الأول الذي يطابق الاسم المقدم ويعيده. إذا تم تحديد اسم مخزن، يتم البحث في هذا المخزن فقط. وإلا، فإنه يبحث في جميع المخازن ويعيد أول نتيجة مطابقة. إذا كان سجل المخزن يحتوي على مخزن افتراضي، يبحث cmdlet في هذا المخزن قبل أي مخزن مسجل آخر. يتم إرجاع الأسرار التي هي أنواع سلسلة أو سلسلة آمنة كعناصر SecureString بشكل افتراضي.

أمثلة

مثال 1

Get-Secret -Name Secret1 -Vault CredMan
Get-Secret -Name Secret1 -Vault CredMan -AsPlainText

System.Security.SecureString
PlainTextSecretString

يبحث هذا المثال عن سر بالاسم Secret1، وهو سر نوع السلسلة . يقوم الأمر الأول بإرجاع البيانات السرية كعنصر SecureString . يستخدم الأمر الثاني المعلمة AsPlainText لإرجاع السر كعنصر String بدلا من ذلك، يتم عرضه في وحدة التحكم كنص عادي.

مثال 2

Get-SecretInfo -Name Secret2 -Vault SecretStore | Get-Secret -AsPlainText

يسترد هذا المثال معلومات سرية للسر المسمى Secret2 في المخزن المسمى SecretStore. ثم يرسل النتيجة من خلال البنية الأساسية لبرنامج ربط العمليات التجارية إلى Get-Secret، والتي تبحث عن البيانات السرية وتعيدها كنص عادي.

المعلمات

-AsPlainText

يحدد أنه يجب إرجاع سر يكون نوعه String أو SecureStringكسلسلة (في نص عادي) بدلا من SecureString. إذا لم يكن السر الذي يتم استرداده سلسلة أو SecureString، فلن يكون لهذه المعلمة أي تأثير.

تنبيه

لضمان الأمان، يجب تجنب استخدام سلاسل النص العادي كلما أمكن ذلك.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

يحدد كائن SecretInformation يمثل سر المخزن بدلا من تحديد معلمات الاسموالمخزن . يمكنك الحصول على عنصر SecretInformation باستخدام Get-SecretInfo cmdlet.

Type:	SecretInformation
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

يحدد اسم السر المراد استرداده. أحرف البدل غير مسموح بها.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Vault

يحدد اسم المخزن المسجل لاسترداد البيانات السرية منه. إذا لم يتم تحديد اسم المخزن، فسيتم البحث في جميع المخازن المسجلة. إذا كان سجل المخزن يحتوي على مخزن افتراضي ولم يتم تحديد هذه المعلمة، فسيتم البحث في المخزن الافتراضي قبل المخازن المسجلة الأخرى.

Type:	String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

الإدخالات

String

Microsoft.PowerShell.SecretManagement.SecretInformation

المخرجات

Object