Import-HgsGuardian

Creates a guardian object from an .xml file.

Syntax

Import-HgsGuardian
      [-Path] <String>
      -Name <String>
      [-AllowExpired]
      [-AllowUntrustedRoot]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Import-HgsGuardian cmdlet creates a Host Guardian Service guardian object from an .xml file. If you specify a name for the guardian, this cmdlet also persists that object in the local guardian store.

Examples

Example 1: Import a guardian

PS C:\> Import-HgsGuardian -Path "C:\MyDirectory\Guardian11.xml" -Name "Guardian11"

This command imports a guardian from the specified .xml file.

Required Parameters

-Name

Specifies the name to associate with this guardian when it is persisted to the local guardian store.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Path

Specifies the path to an XML file containing the Guardian information.

Type:String
Aliases:FilePath
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Optional Parameters

-AllowExpired

Indicates whether to allow guardian creation with certificates that are expired.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AllowUntrustedRoot

Indicates whether to allow a guardian to be created using self-signed certificates.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Outputs

CimInstance#MSFT_HgsGuardian

The Microsoft.Management.Infrastructure.CimInstance object is a wrapper class that displays Windows Management Instrumentation (WMI) objects. The path after the pound sign (#) provides the namespace and class name for the underlying WMI object.