Import-Hgs Guardian

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.