MsiPackage

Статья
05/05/2023

Краткий обзор

Установка или удаление пакета 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

Обязательные свойства

Path

Укажите путь к пакету MSI в виде строки. Это свойство может быть путем к MSI-файлу на локальном компьютере, путем к пакету MSI на UNC-диске или веб-URI, из которого можно скачать пакет MSI. Если значение этого свойства не является веб-универсальным кодом ресурса (URI), оно должно заканчиваться на .msi.

Это свойство используется только с методом Set ресурса. Если значением является веб-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

Ensure

Указывает, следует ли устанавливать или удалять пакет. Чтобы установить пакет, укажите это свойство как 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-сертификатов , если путь является URI HTTPS. Если скриптблок не возвращается $true, метод 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

PackageDescription

Описание пакета MSI.

Type: System.String

Publisher

Издатель пакета MSI.

Type: System.String

Размер

Размер пакета MSI в МБ.

Type: System.UInt32

Версия

Номер версии пакета MSI.

Type: System.String