Sets or updates NFC token object properties.
Set-SystoLockNfcToken [-Algorithm <ProximityTokenAlgorithm>] [-AnswerToReset <String>] [-ApplicationIdentifier <Int32>]
[-ApplicationIndex <Int32>] [-Data <Byte[]>] [-FriendlyName <String>] [-Id] <String[]> [-LockedOn <DateTime>]
[-NotAfter <DateTime>] [-NotBefore <DateTime>] [-NumberOfTransactions <Int64>] [-PassThru]
[-PerformedTransactions <Int64>] [-SerialNumber <String>] [-Type <ProximityTokenType>]
[-Address <ServiceAddress>] [-AuthType <NtdsAuthType>] [-DomainController <String>] [-Timeout <Int32>]
[<CommonParameters>]
Set-SystoLockNfcToken [-Algorithm <ProximityTokenAlgorithm>] [-AnswerToReset <String>] [-ApplicationIdentifier <Int32>]
[-ApplicationIndex <Int32>] [-Data <Byte[]>] [-FriendlyName <String>] [[-InputObject] <ProximityToken>]
[-LockedOn <DateTime>] [-NotAfter <DateTime>] [-NotBefore <DateTime>] [-NumberOfTransactions <Int64>]
[-PassThru] [-PerformedTransactions <Int64>] [-SerialNumber <String>] [-Type <ProximityTokenType>]
[-Address <ServiceAddress>] [-AuthType <NtdsAuthType>] [-DomainController <String>] [-Timeout <Int32>]
[<CommonParameters>]
Set-SystoLockNfcToken -Card <ProximityCard> [-Force] [-Id] <String[]> [-PassThru] [-Address <ServiceAddress>]
[-AuthType <NtdsAuthType>] [-DomainController <String>] [-Timeout <Int32>] [<CommonParameters>]
The Set-SystoLockNfcToken
cmdlet sets additional or updates existing NFC token properties.
The value $null
can be used to remove properties.
All cmdlets interacting with SystoLOCK service have -Address and -Timeout parameters to adjust their behavior.
You can also set $SystoLockAddress and $SystoLockTimeout PowerShell variables or $SystoLockAddress and $SystoLockTimeout environment variables which let you specify these parameters as defaults.
If no parameters or environment variables are specified, the timeout defaults to 3 seconds and the address is obtained from DNS for current domain and site.
Set-SystoLockNfcToken -Id YSNF48151623 -NotBefore '18.10.2024 00:00:00'
Sets NFC token activation time.
Set-SystoLockNfcToken -Id YSNF48151623 -NotAfter '31.12.2032 00:00:00'
Sets NFC token expiration time.
Set-SystoLockNfcToken -Id YSNF48151623 -NumberOfTransactions 100
Sets maximum number of allowed authentication.
Set-SystoLockNfcToken -Id YSNF48151623 -FriendlyName "John's token"
Sets an NFC token friendly name.
Set-SystoLockNfcToken -Id GAKT000168DE -NotBefore '18.10.2024 00:00:00' -NotAfter '31.12.2025 00:00:00' -NumberOfTransactions 69420
Sets multiple properties at once for a token specified by its identifier.
Get-SystoLockNfcCard | Set-SystoLockNfcToken -NumberOfTransactions 69420 -FriendlyName "John's token"
Sets multiple properties at once for a token specified currently preset in a card reader.
Specifies service address (optional).
Accepts an URL, a host name or a Service structure returned by previous Get-SystoLockService call.
Type: ServiceAddress
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies token algorithm.
Possible values: None, Identification, Aes128, TripleDes2K
Type: ProximityTokenAlgorithm
Parameter Sets: Id, InputObject
Aliases:
Accepted values: None, Identification, Aes128, TripleDes2K
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies Answer to Reset (ATR) value in hexadecimal encoded form.
Type: String
Parameter Sets: Id, InputObject
Aliases: ATR
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies token application identifier.
Type: Int32
Parameter Sets: Id, InputObject
Aliases: AppID, AID
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
Specifies token application index.
Type: Int32
Parameter Sets: Id, InputObject
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
Specifies authentication method to use with domain controller (optional).
The acceptable values for this parameter are: Kerberos and Negotiate.
The default method is Kerberos.
Possible values: Kerberos, Negotiate
Type: NtdsAuthType
Parameter Sets: (All)
Aliases:
Accepted values: Kerberos, Negotiate
Required: False
Position: Named
Default value: Kerberos
Accept pipeline input: False
Accept wildcard characters: False
Specifies the token objects to be processed.
Type: ProximityCard
Parameter Sets: Card
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
Specifies token application data.
Type: Byte[]
Parameter Sets: Id, InputObject
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies domain controller name (optional).
Accepts a domain name, a fully qualified domain name or an IP address of the domain controller.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Overrides existing NFC token information.
Type: SwitchParameter
Parameter Sets: Card
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Specifies token friendly name (optional).
Type: String
Parameter Sets: Id, InputObject
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies token identifiers.
Type: String[]
Parameter Sets: Id
Aliases: Identifier
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
Type: String[]
Parameter Sets: Card
Aliases: Identifier
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
Specifies the token objects to be processed.
Type: ProximityToken
Parameter Sets: InputObject
Aliases:
Required: False
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
Specifies when token has be locked (optional, hidden).
Type: DateTime
Parameter Sets: Id, InputObject
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies token usage end date (optional).
Type: DateTime
Parameter Sets: Id, InputObject
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies token usage start date (optional).
Type: DateTime
Parameter Sets: Id, InputObject
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies maximum number of login negotiations (optional).
Type: Int64
Parameter Sets: Id, InputObject
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Returns the NFC token object.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Specifies number of performed transactions (optional, hidden).
Type: Int64
Parameter Sets: Id, InputObject
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
Specifies token serial number or unique identifier.
Type: String
Parameter Sets: Id, InputObject
Aliases: Serial, UID
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies timeout (range: 1 - 30 seconds, default: 3 seconds).
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies token type.
Possible values: Unknown, Generic, NfcTag, MifareDesfire, MifareClassic, MifareUltralight, HidIclass, HidSeos
Type: ProximityTokenType
Parameter Sets: Id, InputObject
Aliases:
Accepted values: Unknown, Generic, MifareDesfire
Required: False
Position: Named
Default value: Unknown
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.
Specifies the token objects to be processed.
Specifies the card objects to be processed.
Identifier: unique NFC card identifier.
Class: the NFC card class.
Type: the NFC card type.
AnswerToReset: the card answer to reset.
Reader: the reader name.
Applications: the SystoLOCK application.
Specifies one or more NFC tokens by token identifier.
Specifies NFC token object to be processed.
This cmdlet does not generate any output, unless PassThru parameter is specified.
Identifier: token identifier.
AssignedTo: Distinguished name of a user the token is assigned to.
Algorithm: NFC token algorithm.
Type: NFC token type.
FriendlyName: token friendly name.
HasConstraints: A boolean value indicating that a token has constraints, such as lifetime or limited number of transactions allowed.
LastUsed: the time when the current token was last used.
PerformedTransactions: the number of times token has been used.
NumberOfTransactions: Maximum number of times the token is allowed to be used.
IsActive: A boolean value indicating whether the token is active, e.g. is not disabled or locked.
DisabledOn: the time when the current token has been disabled.
LockedOn: the time when the current token has been locked.
CreationTime: the time when the current token has been created.
NotAfter: the time after which the token is no longer valid.
NotBefore: the time before which the token is not yet valid.
PinlessLogin: if configured, contains PIN-less configuration properties.
Any cmdlet parameter except Identifier could be set to $null to remove it from the token.