description | external help file | Module Name | ms.date | online version | schema | title |
---|---|---|---|---|---|---|
Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell. |
HgsServer-help.xml |
HgsServer |
12/20/2016 |
2.0.0 |
Import-HgsServerState |
Imports an exported Host Guardian Service state into a Host Guardian Service instance.
Import-HgsServerState [[-XML] <XmlDocument>] -Password <SecureString> [-ImportTpmModeState]
[-ImportActiveDirectoryModeState] [-WhatIf] [-Confirm] [<CommonParameters>]
Import-HgsServerState [[-Path] <String>] -Password <SecureString> [-ImportTpmModeState]
[-ImportActiveDirectoryModeState] [-WhatIf] [-Confirm] [<CommonParameters>]
The Import-HgsServer cmdlet imports the previously exported Host Guardian Service (HGS) state to the existing Host Guardian Service instance.
The cmdlet imports the following Host Guardian Service state from the input file:
- Attestation service policies
- Attestation service configuration data
- Key protection policies
- Key protection configuration data
- Key Protection Signer Certificates and private keys
- Key Protection Encryption Certificates and private keys
Additionally, this cmdlet renews the attestation service signer certificate and updates the key protection service instance with this certificate.
For more information about the scenario terms, see Security and Assurance.
PS C:\> Import-HgsServerState -Path "C:\ExportedHgsServerState.xml" -Password $Pass
This command imports previously exported state on the current HGS server. This command can be called on only one node. The state is automatically replicated to other nodes in the HGS server setup.
The exported state is the output generated from Export-HgsServerState when run against an existing HGS server setup. The password specified must match the password that was passed to Export-HgsServerState.
Use ConvertTo-SecureString to generate a secure string that represents the password.
Indicates that this cmdlet imports and updates Attestation service configuration state relevant to the Active Directory operational mode.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Indicates that this cmdlet imports and updates Attestation service configuration state relevant to the trusted platform module (TPM) operational mode.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the password that the Export-HgsServerState cmdlet used to encrypt the keys.
Type: SecureString
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the path of the file that this cmdlet imports.
Type: String
Parameter Sets: File
Aliases: FilePath
Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the state that this cmdlet imports as an XML document.
Type: XmlDocument
Parameter Sets: XML
Aliases: InputObject
Required: False
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).