Modifier

Partager via

Add-HgsAttestationHostGroup

Module:
HgsAttestation Module

Adds an attestation policy for an Active Directory host group configuration.

Syntax

hostGroup 

Add-HgsAttestationHostGroup
    -Name <String>
    -HostGroup <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

sid 

Add-HgsAttestationHostGroup
    -Name <String>
    -Identifier <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Add-HgsAttestationHostGroup cmdlet adds an Attestation policy that is based on the configuration of an Active Directory host group. Specify a host group by name or security identifier (SID).

Examples

Example 1: Add a host group

PS C:\> Add-HgsAttestationHostGroup -Name "TrustedADHostGroup14" -Identifier $Sid

This command adds a host group from the Active Directory fabric to the Attestation service. The Identifier parameter specifies an SID stored in $Sid. After you run this command, the Attestation service trusts all hosts that belong to this host group to host shielded virtual machines.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-HostGroup

Specifies the name of a host group on which this cmdlet bases the policy. Include the domain.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

hostGroup
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identifier

Specifies the SID of a host group on which this cmdlet bases the policy.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

sid
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies the friendly name of the host group.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

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

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.