win_pagefile – Запрос или изменение конфигурации файла подкачки
Новое в версии 2.4.
Описание
- Запрос текущей конфигурации файла подкачки.
- Включение/выключение автоматического управления файлом подкачки.
- Создание нового или перезапись конфигурации файла подкачки.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| automatic boolean |
| Настраивает автоматическое управление файлом подкачки для всей системы. |
| drive string | Диск, на котором находится файл подкачки. | |
| initial_size integer | Начальный размер файла подкачки в мегабайтах. | |
| maximum_size integer | Максимальный размер файла подкачки в мегабайтах. | |
| override boolean |
| Переопределить текущий файл подкачки на диске. |
| remove_all boolean |
| Удалить все файлы подкачки в системе, не включая автоматически управляемые. |
| state string |
| Состояние файла подкачки. |
| system_managed boolean |
| Настроить текущий файл подкачки для управления системой. |
| test_path boolean |
| Использовать Test-Path на диске, чтобы убедиться, что диск доступен перед созданием файла подкачки. |
Примечания
Примечание
- Существует разница между автоматически управляемыми файлами подкачки, настроенными один раз для всей системы, и файлами подкачки, управляемыми системой, настроенными на каждый файл подкачки.
- InitialSize 0 и MaximumSize 0 означают, что файл подкачки управляется системой.
- Исключение за пределами допустимого диапазона может быть вызвано несколькими причинами, две распространённые проблемы: отсутствующий диск, слишком маленький размер файла подкачки.
- Установка файла подкачки при включённом AutomaticManagedPagefile отключит AutomaticManagedPagefile.
Примеры
- name: Query pagefiles configuration
win_pagefile:
- name: Query C pagefile
win_pagefile:
drive: C
- name: Set C pagefile, don't override if exists
win_pagefile:
drive: C
initial_size: 1024
maximum_size: 1024
override: no
state: present
- name: Set C pagefile, override if exists
win_pagefile:
drive: C
initial_size: 1024
maximum_size: 1024
state: present
- name: Remove C pagefile
win_pagefile:
drive: C
state: absent
- name: Remove all current pagefiles, enable AutomaticManagedPagefile and query at the end
win_pagefile:
remove_all: yes
automatic: yes
- name: Remove all pagefiles disable AutomaticManagedPagefile and set C pagefile
win_pagefile:
drive: C
initial_size: 2048
maximum_size: 2048
remove_all: yes
automatic: no
state: present
- name: Set D pagefile, override if exists
win_pagefile:
drive: d
initial_size: 1024
maximum_size: 1024
state: present
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие — поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| automatic_managed_pagefiles boolean | Когда state — query. | Указывает, управляются ли файлы подкачки автоматически. Пример: True |
| pagefiles list | Когда state — query. | Содержит заголовок, описание, начальный размер, максимальный размер и имя для каждого файла подкачки в системе. Пример: [{'caption': "c:\\ 'pagefile.sys'", 'description': "'pagefile.sys' @ c:\\", 'initial_size': 2048, 'maximum_size': 2048, 'name': 'c:\\pagefile.sys'}, {'caption': "d:\\ 'pagefile.sys'", 'description': "'pagefile.sys' @ d:\\", 'initial_size': 1024, 'maximum_size': 1024, 'name': 'd:\\pagefile.sys'}] |
Статус
- Гарантии обратной совместимости этого модуля нет. [preview]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Liran Nisanov (@LiranNis)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/win_pagefile_module.html