Uninstall-PSResource
Удаляет ресурс, установленный с помощью PowerShellGet.
Синтаксис
Uninstall-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Uninstall-PSResource
[-Prerelease]
[-InputObject] <PSResourceInfo[]>
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Этот командлет объединяет функциональные возможности командлетов Uninstall-Module
и Uninstall-Script
из PowerShellGet версии 2. Командлет выполняет поиск ресурсов с XML-файлом метаданных PowerShellGet по путям установки пакета. Соответствующие ресурсы удаляются из системы.
По умолчанию командлет проверяет, является ли удаляемый ресурс зависимостью для другого ресурса.
Примеры
Пример 1
Удалите последнюю версию модуля Az .
Uninstall-PSResource Az
Пример 2
Удалите определенную версию модуля Az .
Uninstall-PSResource -name Az -version "5.0.0"
Пример 3
Удаляет все версии модуля Az в указанном диапазоне версий.
Uninstall-PSResource -name Az -version "(5.0.0, 7.5.0)"
Пример 4
В этом примере предполагается, что следующие версии модуля Az уже установлены:
- 4.0.1-Preview
- 4.1.0
- 4.0.2 (предварительная версия)
Командлет Uninstall-PSResource
удаляет стабильную и предварительную версию, которая относится к указанному диапазону версий. В соответствии с правилами NuGetVersion предварительная версия меньше стабильной версии, поэтому версия 4.0.1-preview фактически меньше, чем версия 4.0.1 в указанном диапазоне. Поэтому версия 4.0.1-preview не удаляется. Версии 4.1.0 и 4.0.2-preview удаляются, так как они находятся в диапазоне.
Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]"
Пример 5
В этом примере предполагается, что следующие версии модуля Az уже установлены:
- 4.0.1-Preview
- 4.1.0
- 4.0.2 (предварительная версия)
Это аналогично предыдущему примеру, за исключением того, что параметр Prerelease означает, что удаляются только предварительные версии. Удаляется только версия 4.0.2-preview, так как версия 4.0.1-preview выходит за пределы диапазона, а версия 4.1.0 не является предварительной версией.
Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]" -Prerelease
Параметры
-Confirm
Запрос подтверждения перед выполнением командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InputObject
Используется для входных данных конвейера.
Тип: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Name
Имя удаляемого ресурса или ресурсов. Поддерживаются подстановочные знаки, но NuGet принимает *
только символ.
Тип: | String[] |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | True |
-Prerelease
Указывает, что следует удалить только ресурсы предварительной версии.
Тип: | SwitchParameter |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Scope
Указывает область удаляемого ресурса.
Тип: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
Допустимые значения: | CurrentUser, AllUsers |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SkipDependencyCheck
По умолчанию командлет проверяет, является ли удаляемый ресурс зависимостью для другого ресурса. При использовании этого параметра тест зависимостей пропускается.
Тип: | SwitchParameter |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Version
Указывает версию удаляемого ресурса. Значение может быть точной версией или диапазоном версий с помощью синтаксиса управления версиями NuGet.
Дополнительные сведения о диапазонах версий NuGet см. в разделе Управление версиями пакетов.
PowerShellGet поддерживает все версии, кроме минимальной инклюзивной версии , перечисленные в документации по диапазону версий NuGet. Использование 1.0.0.0
в качестве версии не дает версий 1.0.0.0 и выше (минимальный диапазон включительно). Вместо этого значение считается обязательной версией. Для поиска минимального инклюзивного диапазона используйте [1.0.0.0, ]
в качестве диапазона версий.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | True |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
String[]
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Выходные данные
Связанные ссылки
PSResourceGet