MsiPackage

  • مقالة

الخلاصة

تثبيت حزمة MSI أو إلغاء تثبيتها.

بناء الجملة

MsiPackage [String] #ResourceName
{
    Path = [string]
    ProductId = [string]
    [Arguments = [string]]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [FileHash = [string]]
    [HashAlgorithm = [string]{ MD5 | RIPEMD160 | SHA1 | SHA256 | SHA384 | SHA512 }]
    [LogPath = [string]]
    [PsDscRunAsCredential = [PSCredential]]
    [RunAsCredential = [PSCredential]]
    [ServerCertificateValidationCallback = [string]]
    [SignerSubject = [string]]
    [SignerThumbprint = [string]]
}

الوصف

يقوم MsiPackage المورد بتثبيت حزمة MSI أو إلغاء تثبيتها. يمكن أن تكون الحزمة محلية أو على محرك أقراص UNC أو يتم تنزيلها من عنوان URI على الويب. يمكنك تثبيت الحزمة كحساب بديل. يمكنك تحديد وسيطات إضافية للحزمة للتثبيت أو إلغاء التثبيت حسب الحاجة.

المتطلبات

لا شيء

الخصائص الرئيسية

ProductId

حدد رقم التعريف المستخدم للعثور على الحزمة كسلسلة. هذه القيمة عادة ما تكون GUID.

Type: System.String

الخصائص الإلزامية

المسار

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

يتم استخدام هذه الخاصية فقط مع أسلوب تعيين المورد. إذا كانت القيمة هي URI ويب، يقوم المورد بتنزيل الحزمة إلى ذاكرة تخزين مؤقت محلية قبل التثبيت أو إلغاء التثبيت. إذا كانت القيمة عبارة عن مسار UNC، يقوم المورد بتحميل محرك أقراص UNC قبل التثبيت أو إلغاء التثبيت.

Type: System.String

خصائص اختيارية

الوسيطات

حدد الوسيطات الإضافية لتمريرها إلى الحزمة أثناء التثبيت أو إلغاء التثبيت كسلسلة. يتم تمرير الوسيطات التالية دائما:

  • عند التثبيت، /i <Path to the MSI package> هي الوسيطة الأولى.
  • عند إلغاء التثبيت، /x <Product Entry Guid> تكون الوسيطة الأولى.
  • إذا تم تحديد LogPath ، يتم إلحاق المورد بقائمة الوسيطات /log "<LogPath>" . راجع LogPath لمزيد من المعلومات.
  • /quiet ويتم /norestart إلحاقها دائما.

يتم إلحاق قيمة هذه الخاصية بعد الوسيطات الافتراضية.

Type: System.String
Default Value: None

بيانات اعتماد

حدد بيانات اعتماد حساب مع إذن لتحميل مسار UNC إذا لزم الأمر.

Type: System.Management.Automation.PSCredential
Behavior: Write
Default Value: None

ضمان

تحديد ما إذا كنت تريد تثبيت الحزمة أو إلغاء تثبيتها. لتثبيت الحزمة، حدد هذه الخاصية ك Present. لإلغاء تثبيت الحزمة، حدد هذه الخاصية ك Absent. القيمة الافتراضية هي Present.

Type: System.String
Behavior: Write
Accepted Values:
  - Absent
  - Present
Default Value: Present

FileHash

حدد قيمة التجزئة المتوقعة لملف MSI كسلسلة. إذا تم تحديده، يتحقق المورد من الحزمة مقابل هذه القيمة قبل تثبيت الحزمة أو إلغاء تثبيتها. إذا لم تتطابق القيم، يطرح المورد استثناء وسيطة غير صالح.

Type: System.String
Default Value: None

HashAlgorithm

حدد الخوارزمية المستخدمة لإنشاء قيمة FileHash. القيمة الافتراضية هي SHA256.

Type: System.String
Accepted Values:
  - MD5
  - RIPEMD160
  - SHA1
  - SHA256
  - SHA384
  - SHA512
Default Value: SHA256

LogPath

حدد المسار ملف لتسجيل الإخراج من تنفيذ MSI كسلسلة. بشكل افتراضي، لا يتم تسجيل الإخراج.

Type: System.String
Default Value: None

RunAsCredential

حدد بيانات اعتماد حساب بديل لتشغيل تثبيت الحزمة أو إلغاء تثبيتها ك.

Type: System.Management.Automation.PSCredential
Default Value: None

ServerCertificateValidationCallback

حدد حظر البرنامج النصي PowerShell للتحقق من صحة شهادات SSL عندما يكون المسار هو HTTPS URI. إذا لم يرجع $truescriptblock ، فإن أسلوب Set للمورد يطرح استثناء عملية غير صالح ولا يقوم بتنزيل الحزمة.

Type: System.String
Default Value: None

SignerSubject

حدد الموضوع كسلسلة يجب أن تتطابق مع شهادة الموقع للتوقيع الرقمي لملف MSI. إذا تم تحديده، يتحقق المورد من الحزمة مقابل هذه القيمة قبل تثبيت الحزمة أو إلغاء تثبيتها. إذا لم تتطابق القيم، فإن أسلوب Set للمورد يطرح استثناء وسيطة غير صالح.

Type: System.String
Default Value: None

بصمة SignerThumbprint

حدد بصمة الشهادة كسلسلة يجب أن تتطابق مع شهادة الموقع للتوقيع الرقمي لملف MSI. إذا تم تحديده، يتحقق المورد من الحزمة مقابل هذه القيمة قبل تثبيت الحزمة أو إلغاء تثبيتها. إذا لم تتطابق القيم، فإن أسلوب Set للمورد يطرح استثناء وسيطة غير صالح.

Type: System.String
Default Value: None

خصائص القراءة فقط

InstalledOn

التاريخ الذي تم تثبيت حزمة MSI عليه أو صيانته، أيهما أحدث. هذه الخاصية غير قابلة للتكوين.

Type: System.String

InstallSource

المسار إلى حزمة MSI.

Type: System.String

الاسم

اسم العرض لحزمة MSI.

Type: System.String

وصف الحزمة

وصف حزمة MSI.

Type: System.String

الناشر

ناشر حزمة MSI.

Type: System.String

الحجم

حجم حزمة MSI بالميغابايت.

Type: System.UInt32

إصدار

رقم إصدار حزمة MSI.

Type: System.String

أمثلة