Recurso nxPackage de DSC para LinuxDSC for Linux nxPackage Resource

El recurso nxPackage de la configuración de estado deseado (DSC) de PowerShell ofrece un mecanismo para administrar paquetes en un nodo de Linux.The nxPackage resource in PowerShell Desired State Configuration (DSC) provides a mechanism to manage packages on a Linux node.

SintaxisSyntax

nxPackage <string> #ResourceName
{
    Name = <string>
    [ PackageManager = <string> { Yum | Apt | Zypper } ]
    [ PackageGroup = <bool>]
    [ Arguments = <string> ]
    [ ReturnCode = <uint32> ]
    [ FilePath = <string> ]
    [ DependsOn = <string[]> ]
    [ Ensure = <string> { Absent | Present }  ]
}

PropiedadesProperties

PropiedadProperty DescripciónDescription
NombreName El nombre del paquete para el que quiere garantizar un estado específico.The name of the package for which you want to ensure a specific state.
PackageManagerPackageManager Los valores admitidos son yum , apt y zypper .Supported values are yum , apt , and zypper . Especifica el administrador de paquetes que se utilizará al instalar paquetes.Specifies the package manager to use when installing packages. Si se especifica la propiedad FilePath , la ruta de acceso facilitada se usará para instalar el paquete.If FilePath is specified, the provided path will be used to install the package. De lo contrario, se utilizará un administrador de paquetes para instalar el paquete desde un repositorio configurado previamente.Otherwise, a Package Manager will be used to install the package from a pre-configured repository. Si no se facilitan ni PackageManager ni FilePath , se usará el administrador de paquetes predeterminado del sistema.If neither PackageManager nor FilePath are provided, the default package manager for the system will be used.
PackageGroupPackageGroup Si su valor es $true, se espera que el valor Name sea el nombre de un grupo de paquetes que se usará con un elemento PackageManager .If $true, the Name is expected to be the name of a package group for use with a PackageManager . La propiedad PackageGroup no es válida cuando se proporciona un elemento FilePath .PackageGroup is not valid when providing a FilePath .
ArgumentosArguments Una cadena de argumentos que se pasarán al paquete tal y como se faciliten.A string of arguments that will be passed to the package exactly as provided.
ReturnCodeReturnCode El código de retorno esperado.The expected return code. Si el código de retorno real no a coincide con el valor esperado facilitado aquí, la configuración devolverá un error.If the actual return code does not match the expected value provided here, the configuration will return an error.
FilePathFilePath La ruta de acceso donde reside el paquete.The file path where the package resides.

Propiedades comunesCommon properties

PropiedadProperty DescripciónDescription
DependsOnDependsOn Indica que la configuración de otro recurso debe ejecutarse antes de que se configure este recurso.Indicates that the configuration of another resource must run before this resource is configured. Por ejemplo, si el elemento ID del bloque del script de configuración del recurso que quiere ejecutar primero es ResourceName y su tipo es ResourceType, la sintaxis para usar esta propiedad es DependsOn = "[ResourceType]ResourceName".For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".
EnsureEnsure Determina si se debe comprobar si existe el paquete.Determines whether to check if the package exists. Establezca esta propiedad en Present para asegurarse de que el paquete exista.Set this property to Present to ensure the package exists. Establézcala en Absent para asegurarse de que el paquete no exista.Set it to Absent to ensure the package does not exist. El valor predeterminado es Present .The default value is Present .

EjemploExample

En el ejemplo siguiente se garantiza que el paquete denominado "httpd" está instalado en un equipo Linux, mediante el administrador de paquetes "Yum".The following example ensures that the package named "httpd" is installed on a Linux computer, using the "Yum" package manager.

Import-DSCResource -Module nx

Node $node
{
    nxPackage httpd
    {
        Name = "httpd"
        Ensure = "Present"
        PackageManager = "Yum"
    }
}