Reset-SecretStore
يعيد تعيين SecretStore عن طريق حذف جميع البيانات السرية وتكوين المخزن بالخيارات الافتراضية.
بناء الجملة
Reset-SecretStore
[-Scope <SecureStoreScope>]
[-Authentication <Authenticate>]
[-Password <SecureString>]
[-PasswordTimeout <Int32>]
[-Interaction <Interaction>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
الوصف
يقوم أمر cmdlet هذا بإعادة تعيين SecretStore بالكامل عن طريق حذف جميع البيانات السرية التي قد تحتوي عليها، وإعادة تعيين خيارات التكوين إلى قيمها الافتراضية. يتم استخدامه فقط إذا فقدت كلمة مرور مطلوبة، أو أصبحت ملفات البيانات تالفة بحيث لم يعد SecretStore يعمل ولا يمكن الوصول إلى البيانات السرية.
يمكن تجاوز خيارات التكوين الافتراضية عن طريق تحديد معلمات خيار تكوين الأمر الفردية.
أمثلة
مثال 1
PS C:\> Reset-SecretStore -PassThru
WARNING: !!This operation will completely remove all SecretStore module secrets and reset
configuration settings to default values!!
Reset SecretStore
Are you sure you want to erase all secrets in SecretStore and reset configuration settings to default?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): Y
Creating a new Microsoft.PowerShell.SecretStore vault. A password is required by the current store configuration.
Enter password:
********
Enter password again for verification:
********
Scope Authentication PasswordTimeout Interaction
----- -------------- --------------- -----------
CurrentUser Password 900 Prompt
يعيد هذا المثال تعيين SecretStore للمستخدم الحالي. يحذر cmdlet من عواقب هذا الإجراء ويطالب المستخدم بالتأكيد قبل المتابعة. بعد التأكيد، يحذف cmdlet جميع الأسرار ويعين كل إعداد تكوين إلى قيمته الافتراضية.
المعلمات
-Authentication
يحدد كيفية مصادقة الوصول إلى SecretStore. يجب أن تكون Password
القيمة أو None
.
إذا تم تحديده على أنه None
، يتيح cmdlet الوصول إلى SecretStore دون كلمة مرور. المصادقة الافتراضية هي Password
.
تنبيه
تعيين المصادقة إلى None
أقل أمانا من Password
. قد يكون التحديد None
مفيدا لاختبار السيناريوهات ولكن لا ينبغي استخدامه مع الأسرار المهمة.
Type: | Authenticate |
Accepted values: | None, Password |
Position: | Named |
Default value: | Password |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
يطالبك بالتأكيد قبل تشغيل cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
يشير إلى أنه يجب على cmdlet إعادة تعيين SecretStore دون المطالبة. بشكل افتراضي، يحذر cmdlet من تأثير إعادة تعيين SecretStore ويطالب المستخدم بالتأكيد.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Interaction
يحدد ما إذا كان يجب على SecretStore مطالبة المستخدم عند الوصول إليه. إذا كانت القيمة هي Prompt
، تتم مطالبة المستخدم بكلمة المرور الخاصة به في جلسات تفاعلية عند الحاجة. إذا كانت القيمة هي None
، فلن تتم مطالبة المستخدم بكلمة مرور. إذا كانت القيمة وكلمة None
مرور مطلوبة، فإن الأمر cmdlet الذي يتطلب كلمة المرور يطرح خطأ Microsoft.PowerShell.SecretStore.PasswordRequiredException .
Type: | Interaction |
Accepted values: | None, Prompt |
Position: | Named |
Default value: | Prompt |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
يشير إلى أن cmdlet يجب أن يرجع تكوين SecretStore بعد إعادة تعيينه. بشكل افتراضي، لا يرجع cmdlet أي إخراج.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Password
يحدد كلمة المرور التي يجب أن يتطلبها SecretStore للوصول. إذا تم تحديد المصادقة على أنها None
، فإن cmdlet ترجع خطأ. إذا كانت المصادقة هي Password
ولم يتم تحديد هذه المعلمة، يطالب cmdlet المستخدم بإدخال كلمة المرور بشكل آمن.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordTimeout
يحدد المدة التي يظل فيها SecretStore غير مؤمن بعد المصادقة باستخدام كلمة مرور. عند الوصول إلى قيمة المهلة، يتم إبطال قيمة كلمة المرور الحالية لجلسة العمل. يتطلب الوصول إلى SecretStore بعد انتهاء المهلة كلمة المرور مرة أخرى.
Type: | Int32 |
Position: | Named |
Default value: | 900 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
يحدد السياق الذي تم تكوين SecretStore له. مدعوم حاليا فقط CurrentUser
.
Type: | SecureStoreScope |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | CurrentUser |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
تعرض ما سيحدث عند تشغيل الأمر cmdlet. لم يتم تشغيل cmdlet.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
الإدخالات
None
المخرجات
Microsoft.PowerShell.SecretStore.SecureStoreConfig
PowerShell