Uninstall-PSResource
Удаляет ресурс, установленный с помощью PowerShellGet.
Синтаксис
NameParameterSet (По умолчанию)
Uninstall-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObjectParameterSet
Uninstall-PSResource
[-InputObject] <PSResourceInfo[]>
[-Prerelease]
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Этот командлет объединяет функциональные возможности командлетов Uninstall-Module и Uninstall-Script из PowerShellGet версии 2. Командлет выполняет поиск путей установки пакета для ресурсов с файлом метаданных PowerShellGet XML. Соответствующие ресурсы удаляются из системы.
По умолчанию командлет проверяет, является ли удаленный ресурс зависимостью для другого ресурса.
Примеры
Пример 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-preview
Командлет 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-preview
Это то же, что и предыдущий пример, кроме параметра 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
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
| Псевдонимы: | cf |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InputObject
Используется для ввода конвейера.
Свойства параметров
| Тип: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
InputObjectParameterSet
| Позиция: | 0 |
| Обязательный: | True |
| Ценность воронки продаж: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Имя ресурса или ресурсов для удаления. Подстановочные знаки поддерживаются, но NuGet принимает только символ *.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | True |
| Не показывайте: | False |
Наборы параметров
NameParameterSet
| Позиция: | 0 |
| Обязательный: | True |
| Ценность воронки продаж: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Prerelease
Указывает, что следует удалить только ресурсы предварительной версии.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Scope
Указывает область ресурса для удаления.
Свойства параметров
| Тип: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
| Значение по умолчанию: | None |
| Принимаемые значения: | CurrentUser, AllUsers |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SkipDependencyCheck
По умолчанию командлет проверяет, является ли удаленный ресурс зависимостью для другого ресурса. Использование этого параметра пропускает тест зависимостей.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Version
Указывает версию ресурса, который необходимо удалить. Значение может быть точной версией или диапазоном версий с помощью синтаксиса управления версиями NuGet.
Дополнительные сведения о диапазонах версий NuGet см. в управления версиями пакетов.
PowerShellGet поддерживает все, кроме минимальной инклюзивной версии , перечисленных в документации по диапазону версий NuGet. Использование 1.0.0.0, так как версия не дает версий 1.0.0.0 и выше (минимальный инклюзивный диапазон). Вместо этого значение считается обязательной версией. Чтобы найти минимальный диапазон включительно, используйте [1.0.0.0, ] в качестве диапазона версий.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддержка подстановочных знаков: | True |
| Не показывайте: | False |
Наборы параметров
NameParameterSet
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не выполняется.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | False |
| Поддержка подстановочных знаков: | False |
| Не показывайте: | False |
| Псевдонимы: | wi |
Наборы параметров
(All)
| Позиция: | Named |
| Обязательный: | False |
| Ценность воронки продаж: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входы
String
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo
Выходы
Object
Примечания
Модуль определяет usres как псевдоним для Uninstall-PSResource.
