Set-SecretInfo

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

Microsoft.PowerShell.SecretManagement

إضافة بيانات تعريف سرية إضافية إلى بيانات سرية مخزنة حاليا في مخزن أو استبدالها.

بناء الجملة

Set-SecretInfo
   [-Name] <String>
   -SecureStringSecret <SecureString>
   [[-Vault] <String>]
   [[-Metadata] <Hashtable>]
   [-NoClobber]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SecretInfo
   [-Name] <String>
   -Secret <Object>
   [[-Vault] <String>]
   [[-Metadata] <Hashtable>]
   [-NoClobber]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SecretInfo
   -SecretInfo <SecretInformation>
   [-Vault] <String>
   [-NoClobber]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

الوصف

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

لا يتم تخزين بيانات التعريف بشكل آمن في المخزن. يجب ألا تحتوي بيانات التعريف على معلومات حساسة.

أمثلة

مثال 1

Set-SecretInfo -Name Secret1 -Vault Vault1 -Metadata @{ Expiration = ([datetime]::new(2022, 5, 1)) }
Get-SecretInfo -Name Secret1 -Vault Vault1 | Select-Object Name,Metadata

Name         Metadata
----         --------
Secret1 {[Expiration, 5/1/2022 12:00:00 AM]}

يضيف هذا المثال بيانات التعريف إلى البيانات السرية المخزنة Secret1 في Vault1 المخزن. Get-SecretInfo يسترد بيانات Secret1 التعريف لإظهار بيانات التعريف المضافة.

مثال 2

Set-SecretInfo -Name Secret2 -Vault Vault2 -Metadata @{ Expiration = ([datetime]::new(2022, 5, 1)) }

Set-SecretInfo: Cannot set secret metadata Secret2. Vault Vault2 does not support secret metadata.

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

المعلمات

-Confirm

يطالبك بالتأكيد قبل تشغيل cmdlet.

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

-Metadata

يحدد Hashtable يحتوي على أزواج قيمة المفتاح لإقرانه بالبيانات السرية في المخزن. قد لا يدعم مخزن الملحقات المحدد بيانات التعريف السرية. إذا كان المخزن لا يدعم بيانات التعريف، تفشل العملية وترجع خطأ. يجب أن تكون قيم أي بيانات تعريف في hashtable أحد الأنواع التالية:

• string
• Int
• التاريخ والوقت

لا يتم تخزين بيانات التعريف بشكل آمن في المخزن. يجب ألا تحتوي بيانات التعريف على معلومات حساسة.

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

-Name

يحدد اسم السر لإضافة بيانات التعريف إليه. أحرف البدل (*) غير مسموح بها.

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

-NoClobber

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

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

-Secret

يحدد قيمة السر. يجب أن يكون نوع الكائن أحد الأنواع المدعومة:

• بايت[]
• سلسلة
• سلسلة آمنة
• PSCredential
• جدول تجزئة

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

-SecretInfo

يحدد كائن SecretInformation يصف سرا مخزنا تم إرجاعه بواسطة Get-SecretInfo. وهذا يمكن نسخ البيانات السرية من مخزن ملحق إلى آخر.

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

-SecureStringSecret

يحدد قيمة السر ككائن SecretString .

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

-Vault

يحدد اسم المخزن الذي يحتوي على البيانات السرية لإضافة بيانات التعريف أو تحديثها. أحرف البدل (*) غير مسموح بها. بشكل افتراضي، يبحث cmdlet هذا عن السر في المخزن الافتراضي للمستخدم الحالي.

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

-WhatIf

تعرض ما سيحدث عند تشغيل الأمر cmdlet. لم يتم تشغيل cmdlet.

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

الإدخالات

Hashtable

المخرجات

None