Nota

Este complemento es parte del colección ansible.windows (versión 1.3.0).

Para instalarlo usa: ansible-galaxy collection install ansible.windows.

Para usarlo en un libro de jugadas, especifique: ansible.windows.win_reg_stat.

  • Sinopsis
  • Parámetros
  • notas
  • Ver también
  • Ejemplos
  • Valores devueltos

Sinopsis

  • Me gusta ansible.windows.win_file, ansible.windows.win_reg_stat regresará si el key/la propiedad existe.
  • También devuelve el sub keys y propiedades de la key especificado.
  • Si especifica un nombre de propiedad a través de propiedaddevolverá la información específica para esa propiedad.

Parámetros

Parámetro Opciones/Predeterminados Comentarios
nombrestring El nombre de la propiedad de registro para obtener información, el json de retorno no incluirá las sub_claves y las entradas de propiedades para el key especificado. Establecer en un vacío string apuntar al registro key’s (Default) El valor de la propiedad.
alias: entrada, valor, propiedad
senderostring / requerido el registro completo key ruta que incluye la colmena a buscar.
alias: key

notas

Nota

  • Él properties el valor de retorno contendrá un vacío string key "" que se refiere a la key’s Default valor. Si no se ha establecido el valor, esto key no se devuelve.

Ver también

Ver también

ansible.windows.win_regedit

La documentación oficial sobre el ansible.windows.win_regedit módulo.

ansible.windows.win_regmerge

La documentación oficial sobre el ansible.windows.win_regmerge módulo.

Ejemplos

-name: Obtain information about a registry key using short form
  ansible.windows.win_reg_stat:path: HKLM:SOFTWAREMicrosoftWindowsCurrentVersion
  register: current_version

-name: Obtain information about a registry key property
  ansible.windows.win_reg_stat:path: HKLM:SOFTWAREMicrosoftWindowsCurrentVersion
    name: CommonFilesDir
  register: common_files_dir

-name: Obtain the registry key's (Default) property
  ansible.windows.win_reg_stat:path: HKLM:SOFTWAREMicrosoftWindowsCurrentVersion
    name:''register: current_version_default

Valores devueltos

Los valores de retorno comunes están documentados aquílos siguientes son los campos exclusivos de este módulo:

Llave devuelto Descripción
cambióbooleano siempre Si se cambió algo.
Muestra:Verdadero
existebooleano el éxito y la ruta/la propiedad existen Indica si el registro key/la propiedad existe.
Muestra:Verdadero
propiedadesdiccionario éxito, la ruta existe y la propiedad no está especificada Un diccionario que contiene todas las propiedades y sus valores en el registro key.
Muestra:”: ‘raw_value’: ”, ‘type’: ‘REG_SZ’, ‘value’: ”, ‘binary_property’: ‘raw_value’: [‘0x01’, ‘0x16′]’tipo’: ‘REG_BINARY’, ‘valor’: [1, 22], ‘multi_string_property’: ‘raw_value’: [‘a’, ‘b’]’tipo’: ‘REG_MULTI_SZ’, ‘valor’: [‘a’, ‘b’]
valor brutostring éxito, existe ruta/propiedad y propiedad especificada Devuelve el valor bruto de la propiedad de registro, REG_EXPAND_SZ no tiene string expansión, REG_BINARY o REG_NONE está en formato hexadecimal 0x. REG_NONE, este valor es un hexadecimal string en el formato 0x.
Muestra:%ProgramDir%\Archivos comunes
sub_claveslista / elementos=string éxito, la ruta existe y la propiedad no está especificada Una lista de todos los sub keys de El key especificado.
Muestra:[‘AppHost’, ‘Casting’, ‘DateTime’]
tipostring éxito, existe ruta/propiedad y propiedad especificada El tipo de propiedad.
Muestra:REG_EXPAND_SZ
valorstring éxito, existe ruta/propiedad y propiedad especificada El valor de la propiedad.
Muestra:C:\Archivos de programa\Archivos comunes

Autores

  • Jordan Borean (@jborean93)