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

Примечание

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

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

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

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

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

Описание

Запрос текущей конфигурации файла подкачки.
Включение/выключение автоматического управления файлом подкачки.
Создание нового или переопределение конфигурации файла подкачки.

Параметры

Параметр	Комментарии
automatic boolean	Настройка автоматического управления файлом подкачки для всей системы. Варианты: `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	Содержит заголовок, описание, начальный размер, максимальный размер и имя для каждого файла подкачки в системе. Возвращается: Когда 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

Содержит заголовок, описание, начальный размер, максимальный размер и имя для каждого файла подкачки в системе.

Возвращается: Когда 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_pagefile_module.html