Windows PowerShell command on Get-command Set-TpmOwnerAuth

NAME
    Set-TpmOwnerAuth
    
SYNOPSIS
    Changes the TPM owner authorization value.
    
    
SYNTAX
    Set-TpmOwnerAuth -File  -NewFile  []
    
    Set-TpmOwnerAuth -File  -NewOwnerAuthorization  []
    
    Set-TpmOwnerAuth [[-OwnerAuthorization] ] -NewFile  []
    
    Set-TpmOwnerAuth [[-OwnerAuthorization] ] -NewOwnerAuthorization  []
    
    
DESCRIPTION
    The Set-TpmOwnerAuth cmdlet changes the current owner authorization value of the Trusted Platform Module (TPM) to 
    a new value. You can specify the current owner authorization value or specify a file that contains the current 
    owner authorization value. If you do not specify an owner authorization value, the cmdlet attempts to read the 
    value from the registry.
    
    Use the ConvertTo-TpmOwnerAuth cmdlet to create an owner authorization value. You can specify a new owner 
    authorization value or specify a file that contains the new value.
    
    An owner authorization file is not a simply a password. It is generated for a specific system. For more 
    information on TPM, see the Trusted Platform Module Technology Overview 
    (http://technet.microsoft.com/en-us/library/jj131725.aspx) in the Technet library.
    

PARAMETERS
    -File 
        Specifies a file that contains the current owner authorization value for the TPM. You can use the TPM 
        Management Console to create this file.
        
        Required?                    true
        Position?                    named
        Default value                none
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -NewFile 
        Specifies a file that contains the new owner authorization value for a TPM.
        
        Required?                    true
        Position?                    named
        Default value                none
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    -NewOwnerAuthorization 
        Specifies a new owner authorization value for a TPM.
        
        Required?                    true
        Position?                    named
        Default value                none
        Accept pipeline input?       True (ByValue)
        Accept wildcard characters?  false
        
    -OwnerAuthorization []
        Specifies the current owner authorization value for a TPM.
        
        Required?                    false
        Position?                    1
        Default value                none
        Accept pipeline input?       false
        Accept wildcard characters?  false
        
    
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer, PipelineVariable, and OutVariable. For more information, see 
        about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216). 
    
INPUTS
        String
    
        This cmdlet accepts the owner authorization value for the TPM.
    
    
OUTPUTS
        TpmObject
    
        This cmdlet returns a TpmObject object contains the following information:
        
        -- TpmReady. Whether a TPM complies with Windows Serverr 2012 standards.
        -- TpmPresent. Whether there is a TMP on the current computer.
        -- ManagedAuthLevel. The level at which the operating system manages the owner authorization. Possible values 
        are Legacy, Balanced, and Full.
        -- OwnerClearDisabled. Whether TPM can be reset. If this value is True, the TPM cannot be reset through the 
        operating system by using the owner authorization value. If this value is False, the TPM can be reset through 
        the operating system. 
        -- AutoProvisioning. Whether the computer can use auto-provisioning. Possible values are NotDefined, Enabled, 
        Disabled, and DisabledForNextBoot.
        -- LockedOut. Whether a TPM is locked out.
        -- SelfTest. Information returned by a test that TPM runs.
    
    
    Example 1: Replace imported owner authorization value
    
    PS C:\> Set-TpmOwnerAuth -NewOwnerAuthorization "h4FCmNeWVNp5IMHxRfFL9QEq4vM="
    TpmReady           : True
    TpmPresent         : True
    ManagedAuthLevel   : Full
    OwnerAuth          : h4FCmNeWVNp5IMHxRfFL9QEq4vM=
    OwnerClearDisabled : True
    AutoProvisioning   : DisabledForNextBoot
    LockedOut          : False
    SelfTest           : {191, 191, 245, 191...}
    
    This command replaces the current owner authorization value with the specified owner authorization value. The 
    command does not specify the current owner authorization value, so the cmdlet attempts to find it in the registry. 
    This command does not import the owner authorization value into the registry. After you run this command, you can 
    use the Import-TpmOwnerAuth cmdlet to import the new value into the registry, if necessary.
    
    
    Example 2: Replace owner authorization value with value in file
    
    PS C:\> Set-TpmOwnerAuth -NewFile "NewOwnerAuth.tpm"
    TpmReady           : True
    TpmPresent         : True
    ManagedAuthLevel   : Full
    OwnerAuth          : h4FCmNeWVNp5IMHxRfFL9QEq4vM=
    OwnerClearDisabled : True
    AutoProvisioning   : DisabledForNextBoot
    LockedOut          : False
    SelfTest           : {191, 191, 245, 191...}
    
    This command replaces the current owner authorization value with the owner authorization value in the specified 
    file.
    
    
    Example 3: Replace owner authorization value
    
    PS C:\> Set-TpmOwnerAuth -OwnerAuthorization "oaVq17hNcFS2KSnHwpZa4AlrWBo=" -NewOwnerAuthorization 
    "h4FCmNeWVNp5IMHxRfFL9QEq4vM="
    TpmReady           : True
    TpmPresent         : True
    ManagedAuthLevel   : Full
    OwnerAuth          : h4FCmNeWVNp5IMHxRfFL9QEq4vM=
    OwnerClearDisabled : True
    AutoProvisioning   : DisabledForNextBoot
    LockedOut          : False
    SelfTest           : {191, 191, 245, 191...}
    
    This command replaces the specified owner authorization value with a new owner authorization value.
    
    
    
RELATED LINKS
    Online Version: 
    ConvertTo-TpmOwnerAuth 
    Import-TpmOwnerAuth