تمرين - استخدام التعليمات - Training

دقيقة واحدة

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

استخدام Get-Help لاكتشاف الأوامر

استخدم الأمر cmdlet Get-Help لمعرفة المزيد عن أوامر cmdlets.

شغَّل الأمر Get-Help:

Get-Help -Name Get-FileHash

تنتج عن هذا الأمر مخرجات مشابهة للنص التالي:

NAME
    Get-FileHash

SYNOPSIS
    Computes the hash value for a file by using a specified hash algorithm.

SYNTAX
    Get-FileHash [-InputStream] <System.IO.Stream> [[-Algorithm] {SHA1 | SHA256 | SHA384 | SHA512 | MD5}] 
    [<CommonParameters>]

    Get-FileHash [-LiteralPath] <System.String[]> [[-Algorithm] {SHA1 | SHA256 | SHA384 | SHA512 | MD5}] 
    [<CommonParameters>]

    Get-FileHash [-Path] <System.String[]> [[-Algorithm] {SHA1 | SHA256 | SHA384 | SHA512 | MD5}] 
    [<CommonParameters>]

DESCRIPTION
    The `Get-FileHash` cmdlet computes the hash value for a file by using a specified hash algorithm. A hash value 
    is a unique value that corresponds to the content of the file. Rather than identifying the contents of a file 
    by its file name, extension, or other designation, a hash assigns a unique value to the contents of a file. 
    File names and extensions can be changed without altering the content of the file, and without changing the 
    hash value. Similarly, the file's content can be changed without changing the name or extension. However, 
    changing even a single character in the contents of a file changes the hash value of the file.

    The purpose of hash values is to provide a cryptographically-secure way to verify that the contents of a file 
    have not been changed. While some hash algorithms, including MD5 and SHA1, are no longer considered secure 
    against attack, the goal of a secure hash algorithm is to render it impossible to change the contents of a file 
    -- either by accident, or by malicious or unauthorized attempt -- and maintain the same hash value. You can 
    also use hash values to determine if two different files have exactly the same content. If the hash values of 
    two files are identical, the contents of the files are also identical.

    By default, the `Get-FileHash` cmdlet uses the SHA256 algorithm, although any hash algorithm that is supported 
    by the target operating system can be used.

RELATED LINKS
    Online Version: https://learn.microsoft.com/powershell/module/microsoft.powershell.utility/get-filehash?view=powe
    rshell-7.2&WT.mc_id=ps-gethelp
    Format-List 

REMARKS
    To see the examples, type: "Get-Help Get-FileHash -Examples"
    For more information, type: "Get-Help Get-FileHash -Detailed"
    For technical information, type: "Get-Help Get-FileHash -Full"
    For online help, type: "Get-Help Get-FileHash -Online"

نظرًا لصعوبة قراءة هذا الإخراج، تقرر استخدام بديل أقل تفصيلاً. وهذا يعني أنك تستخدم الاسم المستعار help.

أدخل الأمر help.

help Get-FileHash

الآن، معروض نسخة مصغرة من إخراج التعليمات. يبدو مثل النص التالي:

NAME
    Get-FileHash

SYNOPSIS
    Computes the hash value for a file by using a specified hash algorithm.

SYNTAX
    Get-FileHash [-InputStream] <System.IO.Stream> [[-Algorithm] {SHA1 | SHA256 | SHA384 | SHA512 | MD5}] 
    [<CommonParameters>]

    Get-FileHash [-LiteralPath] <System.String[]> [[-Algorithm] {SHA1 | SHA256 | SHA384 | SHA512 | MD5}] 
    [<CommonParameters>]

    Get-FileHash [-Path] <System.String[]> [[-Algorithm] {SHA1 | SHA256 | SHA384 | SHA512 | MD5}] 
    [<CommonParameters>]

DESCRIPTION
    The `Get-FileHash` cmdlet computes the hash value for a file by using a specified hash algorithm. A hash value 
    is a unique value that corresponds to the content of the file. Rather than identifying the contents of a file 
    by its file name, extension, or other designation, a hash assigns a unique value to the contents of a file. 
    File names and extensions can be changed without altering the content of the file, and without changing the 
    hash value. Similarly, the file's content can be changed without changing the name or extension. However, 
    changing even a single character in the contents of a file changes the hash value of the file.

    The purpose of hash values is to provide a cryptographically-secure way to verify that the contents of a file 
    have not been changed. While some hash algorithms, including MD5 and SHA1, are no longer considered secure 
    against attack, the goal of a secure hash algorithm is to render it impossible to change the contents of a file 
    -- either by accident, or by malicious or unauthorized attempt -- and maintain the same hash value. You can 
    also use hash values to determine if two different files have exactly the same content. If the hash values of 
    two files are identical, the contents of the files are also identical.

    By default, the `Get-FileHash` cmdlet uses the SHA256 algorithm, although any hash algorithm that is supported 
    by the target operating system can be used.

يمكنك التنقل بين النتائج عموديًا وصفًا تلو الآخر باستخدام مفاتيح الأسهم. لعرض النتائج صفحة تلو الأخرى، استخدم مفتاح المسافة.

تشغيل help Get-FileHash -Examples:

help Get-FileHash -Examples

يبدو الإخراج مثل النص التالي:

NAME
    Get-FileHash

SYNOPSIS
    Computes the hash value for a file by using a specified hash algorithm.


    --------- Example 1: Compute the hash value for a file ---------

    Get-FileHash /etc/apt/sources.list | Format-List

    Algorithm : SHA256
    Hash      : 3CBCFDDEC145E3382D592266BE193E5BE53443138EE6AB6CA09FF20DF609E268
    Path      : /etc/apt/sources.list


    ------ Example 2: Compute the hash value for an ISO file ------

    Get-FileHash C:\Users\user1\Downloads\Contoso8_1_ENT.iso -Algorithm SHA384 | Format-List

    Algorithm : SHA384
    Hash      : 20AB1C2EE19FC96A7C66E33917D191A24E3CE9DAC99DB7C786ACCE31E559144FEAFC695C58E508E2EBBC9D3C96F21FA3
    Path      : C:\Users\user1\Downloads\Contoso8_1_ENT.iso

يحتوي هذا الإخراج على قائمة من الأمثلة التي تستخدم الأمر cmdlet. حدد موقع جزء الاستجابة الذي يحتوي على النص Example 1. يوضح هذا الجزء من النص كيف يمكنك استخدام Get-FileHash مع مسار ملف من خلال توجيهه إلى cmdlet Format-List.

تلميح

لمشاهدة مثال سريعًا، أضف العلامة -Examples عند البحث عن التعليمات.

متابعة

تمرين - استخدام التعليمات

استخدام Get-Help لاكتشاف الأوامر

الملاحظات