Модуль community.windows.win_pagefile — получение или изменение конфигурации файла подкачки

Примечание

Этот модуль входит в коллекцию community.windows (версия 3.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.windows.

Чтобы использовать её в плейбуке, укажите: community.windows.win_pagefile.

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Получение текущей конфигурации файла подкачки.
Включение/отключение AutomaticManagedPagefile.
Создание новой или переопределение конфигурации файла подкачки.

Параметры

Параметр	Комментарии
automatic boolean	Настраивает AutomaticManagedPagefile для всей системы. Варианты: `false` `true`
drive string	Диск, на котором находится файл подкачки.
initial_size integer	Начальный размер файла подкачки в мегабайтах.
maximum_size integer	Максимальный размер файла подкачки в мегабайтах.
override boolean	Переопределить текущий файл подкачки на диске. Варианты: `false` `true` ← (по умолчанию)
remove_all boolean	Удалить все файлы подкачки в системе, за исключением файлов, управляемых автоматически. Варианты: `false` ← (по умолчанию) `true`
state string	Состояние файла подкачки. Варианты: `"absent"` `"present"` `"query"` ← (по умолчанию)
system_managed boolean	Настраивает управление текущим файлом подкачки системой. Варианты: `false` ← (по умолчанию) `true`
test_path boolean	Использовать Test-Path для проверки доступности диска перед созданием файла подкачки. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Автоматическое управление файлами подкачки, настраиваемое один раз для всей системы, отличается от управления файлом подкачки системой, которое настраивается отдельно для каждого файла.
Значения InitialSize 0 и MaximumSize 0 означают, что файл подкачки управляется системой.
Исключение о выходе значения за допустимый диапазон может быть вызвано разными проблемами; две распространённые причины — отсутствие такого диска и слишком маленький размер файла подкачки.
При настройке файла подкачки, когда включён AutomaticManagedPagefile, AutomaticManagedPagefile будет отключён.

Примеры

- name: Query pagefiles configuration
  community.windows.win_pagefile:

- name: Query C pagefile
  community.windows.win_pagefile:
    drive: C

- name: Set C pagefile, don't override if exists
  community.windows.win_pagefile:
    drive: C
    initial_size: 1024
    maximum_size: 1024
    override: false
    state: present

- name: Set C pagefile, override if exists
  community.windows.win_pagefile:
    drive: C
    initial_size: 1024
    maximum_size: 1024
    state: present

- name: Remove C pagefile
  community.windows.win_pagefile:
    drive: C
    state: absent

- name: Remove all current pagefiles, enable AutomaticManagedPagefile and query at the end
  community.windows.win_pagefile:
    remove_all: true
    automatic: true

- name: Remove all pagefiles disable AutomaticManagedPagefile and set C pagefile
  community.windows.win_pagefile:
    drive: C
    initial_size: 2048
    maximum_size: 2048
    remove_all: true
    automatic: false
    state: present

- name: Set D pagefile, override if exists
  community.windows.win_pagefile:
    drive: d
    initial_size: 1024
    maximum_size: 1024
    state: present

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ	Описание
automatic_managed_pagefiles boolean	Указывает, управляются ли файлы подкачки автоматически. Возвращается: Когда state имеет значение query. Пример: `true`
pagefiles list / elements=string	Содержит caption, description, initial_size, maximum_size и name для каждого файла подкачки в системе. Возвращается: Когда 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"}]`

Ключ

Описание

automatic_managed_pagefiles

boolean

Указывает, управляются ли файлы подкачки автоматически.

Возвращается: Когда state имеет значение query.

Пример: true

pagefiles

list / elements=string

Содержит caption, description, initial_size, maximum_size и name для каждого файла подкачки в системе.

Возвращается: Когда 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"}]

Авторы

Liran Nisanov (@LiranNis)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/windows/win_pagefile_module.html