< Back
Invoke-FreeIPAAPIcert_find
Post
NAME Invoke-FreeIPAAPIcert_find
SYNOPSIS
SYNTAX
Invoke-FreeIPAAPIcert_find [[-certificate] <String>] [[-issuer] <String>] [[-revocation_reason] <Int32>] [[-ca]
<String>] [[-subject] <String>] [[-min_serial_number] <Int32>] [[-max_serial_number] <Int32>] [-exactly]
[[-validnotafter_from] <DateTime>] [[-validnotafter_to] <DateTime>] [[-validnotbefore_from] <DateTime>]
[[-validnotbefore_to] <DateTime>] [[-issuedon_from] <DateTime>] [[-issuedon_to] <DateTime>] [[-revokedon_from]
<DateTime>] [[-revokedon_to] <DateTime>] [-pkey_only] [[-timelimit] <Int32>] [[-sizelimit] <Int32>] [-all] [-raw]
[[-version] <String>] [-no_members] [[-users] <String[]>] [[-no_users] <String[]>] [[-hosts] <String[]>]
[[-no_hosts] <String[]>] [[-services] <String[]>] [[-no_services] <String[]>] [[-criteria] <String>]
[-FullResultsOutput] [<CommonParameters>]
DESCRIPTION
Search for existing certificates.
PARAMETERS
-certificate <String>
Base-64 encoded certificate.
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-issuer <String>
Issuer DN
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-revocation_reason <Int32>
Reason for revoking the certificate (0-10). Type "ipa help cert" for revocation reason details.
Required? false
Position? 3
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-ca <String>
Name of issuing CA
Required? false
Position? 4
Default value
Accept pipeline input? false
Accept wildcard characters? false
-subject <String>
Subject
Required? false
Position? 5
Default value
Accept pipeline input? false
Accept wildcard characters? false
-min_serial_number <Int32>
minimum serial number
Required? false
Position? 6
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-max_serial_number <Int32>
maximum serial number
Required? false
Position? 7
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-exactly [<SwitchParameter>]
match the common name exactly
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-validnotafter_from <DateTime>
Valid not after from this date (YYYY-mm-dd)
Required? false
Position? 8
Default value
Accept pipeline input? false
Accept wildcard characters? false
-validnotafter_to <DateTime>
Valid not after to this date (YYYY-mm-dd)
Required? false
Position? 9
Default value
Accept pipeline input? false
Accept wildcard characters? false
-validnotbefore_from <DateTime>
Valid not before from this date (YYYY-mm-dd)
Required? false
Position? 10
Default value
Accept pipeline input? false
Accept wildcard characters? false
-validnotbefore_to <DateTime>
Valid not before to this date (YYYY-mm-dd)
Required? false
Position? 11
Default value
Accept pipeline input? false
Accept wildcard characters? false
-issuedon_from <DateTime>
Issued on from this date (YYYY-mm-dd)
Required? false
Position? 12
Default value
Accept pipeline input? false
Accept wildcard characters? false
-issuedon_to <DateTime>
Issued on to this date (YYYY-mm-dd)
Required? false
Position? 13
Default value
Accept pipeline input? false
Accept wildcard characters? false
-revokedon_from <DateTime>
Revoked on from this date (YYYY-mm-dd)
Required? false
Position? 14
Default value
Accept pipeline input? false
Accept wildcard characters? false
-revokedon_to <DateTime>
Revoked on to this date (YYYY-mm-dd)
Required? false
Position? 15
Default value
Accept pipeline input? false
Accept wildcard characters? false
-pkey_only [<SwitchParameter>]
Results should contain primary key attribute only ("certificate")
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-timelimit <Int32>
Time limit of search in seconds (0 is unlimited)
Required? false
Position? 16
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-sizelimit <Int32>
Maximum number of entries returned (0 is unlimited)
Required? false
Position? 17
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-all [<SwitchParameter>]
Retrieve and print all attributes from the server. Affects command output.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-raw [<SwitchParameter>]
Print entries as stored on the server. Only affects output format.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-version <String>
Client version. Used to determine if server will accept request.
Required? false
Position? 18
Default value
Accept pipeline input? false
Accept wildcard characters? false
-no_members [<SwitchParameter>]
Suppress processing of membership attributes.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-users <String[]>
Search for certificates with these owner users.
Required? false
Position? 19
Default value
Accept pipeline input? false
Accept wildcard characters? false
-no_users <String[]>
Search for certificates without these owner users.
Required? false
Position? 20
Default value
Accept pipeline input? false
Accept wildcard characters? false
-hosts <String[]>
Search for certificates with these owner hosts.
Required? false
Position? 21
Default value
Accept pipeline input? false
Accept wildcard characters? false
-no_hosts <String[]>
Search for certificates without these owner hosts.
Required? false
Position? 22
Default value
Accept pipeline input? false
Accept wildcard characters? false
-services <String[]>
Search for certificates with these owner services.
Required? false
Position? 23
Default value
Accept pipeline input? false
Accept wildcard characters? false
-no_services <String[]>
Search for certificates without these owner services.
Required? false
Position? 24
Default value
Accept pipeline input? false
Accept wildcard characters? false
-criteria <String>
A string searched in all relevant object attributes
Required? false
Position? 25
Default value
Accept pipeline input? false
Accept wildcard characters? false
-FullResultsOutput [<SwitchParameter>]
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
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
OUTPUTS
System.Management.Automation.PSObject
RELATED LINKS
SYNOPSIS
SYNTAX
Invoke-FreeIPAAPIcert_find [[-certificate] <String>] [[-issuer] <String>] [[-revocation_reason] <Int32>] [[-ca]
<String>] [[-subject] <String>] [[-min_serial_number] <Int32>] [[-max_serial_number] <Int32>] [-exactly]
[[-validnotafter_from] <DateTime>] [[-validnotafter_to] <DateTime>] [[-validnotbefore_from] <DateTime>]
[[-validnotbefore_to] <DateTime>] [[-issuedon_from] <DateTime>] [[-issuedon_to] <DateTime>] [[-revokedon_from]
<DateTime>] [[-revokedon_to] <DateTime>] [-pkey_only] [[-timelimit] <Int32>] [[-sizelimit] <Int32>] [-all] [-raw]
[[-version] <String>] [-no_members] [[-users] <String[]>] [[-no_users] <String[]>] [[-hosts] <String[]>]
[[-no_hosts] <String[]>] [[-services] <String[]>] [[-no_services] <String[]>] [[-criteria] <String>]
[-FullResultsOutput] [<CommonParameters>]
DESCRIPTION
Search for existing certificates.
PARAMETERS
-certificate <String>
Base-64 encoded certificate.
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-issuer <String>
Issuer DN
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-revocation_reason <Int32>
Reason for revoking the certificate (0-10). Type "ipa help cert" for revocation reason details.
Required? false
Position? 3
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-ca <String>
Name of issuing CA
Required? false
Position? 4
Default value
Accept pipeline input? false
Accept wildcard characters? false
-subject <String>
Subject
Required? false
Position? 5
Default value
Accept pipeline input? false
Accept wildcard characters? false
-min_serial_number <Int32>
minimum serial number
Required? false
Position? 6
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-max_serial_number <Int32>
maximum serial number
Required? false
Position? 7
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-exactly [<SwitchParameter>]
match the common name exactly
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-validnotafter_from <DateTime>
Valid not after from this date (YYYY-mm-dd)
Required? false
Position? 8
Default value
Accept pipeline input? false
Accept wildcard characters? false
-validnotafter_to <DateTime>
Valid not after to this date (YYYY-mm-dd)
Required? false
Position? 9
Default value
Accept pipeline input? false
Accept wildcard characters? false
-validnotbefore_from <DateTime>
Valid not before from this date (YYYY-mm-dd)
Required? false
Position? 10
Default value
Accept pipeline input? false
Accept wildcard characters? false
-validnotbefore_to <DateTime>
Valid not before to this date (YYYY-mm-dd)
Required? false
Position? 11
Default value
Accept pipeline input? false
Accept wildcard characters? false
-issuedon_from <DateTime>
Issued on from this date (YYYY-mm-dd)
Required? false
Position? 12
Default value
Accept pipeline input? false
Accept wildcard characters? false
-issuedon_to <DateTime>
Issued on to this date (YYYY-mm-dd)
Required? false
Position? 13
Default value
Accept pipeline input? false
Accept wildcard characters? false
-revokedon_from <DateTime>
Revoked on from this date (YYYY-mm-dd)
Required? false
Position? 14
Default value
Accept pipeline input? false
Accept wildcard characters? false
-revokedon_to <DateTime>
Revoked on to this date (YYYY-mm-dd)
Required? false
Position? 15
Default value
Accept pipeline input? false
Accept wildcard characters? false
-pkey_only [<SwitchParameter>]
Results should contain primary key attribute only ("certificate")
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-timelimit <Int32>
Time limit of search in seconds (0 is unlimited)
Required? false
Position? 16
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-sizelimit <Int32>
Maximum number of entries returned (0 is unlimited)
Required? false
Position? 17
Default value 0
Accept pipeline input? false
Accept wildcard characters? false
-all [<SwitchParameter>]
Retrieve and print all attributes from the server. Affects command output.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-raw [<SwitchParameter>]
Print entries as stored on the server. Only affects output format.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-version <String>
Client version. Used to determine if server will accept request.
Required? false
Position? 18
Default value
Accept pipeline input? false
Accept wildcard characters? false
-no_members [<SwitchParameter>]
Suppress processing of membership attributes.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-users <String[]>
Search for certificates with these owner users.
Required? false
Position? 19
Default value
Accept pipeline input? false
Accept wildcard characters? false
-no_users <String[]>
Search for certificates without these owner users.
Required? false
Position? 20
Default value
Accept pipeline input? false
Accept wildcard characters? false
-hosts <String[]>
Search for certificates with these owner hosts.
Required? false
Position? 21
Default value
Accept pipeline input? false
Accept wildcard characters? false
-no_hosts <String[]>
Search for certificates without these owner hosts.
Required? false
Position? 22
Default value
Accept pipeline input? false
Accept wildcard characters? false
-services <String[]>
Search for certificates with these owner services.
Required? false
Position? 23
Default value
Accept pipeline input? false
Accept wildcard characters? false
-no_services <String[]>
Search for certificates without these owner services.
Required? false
Position? 24
Default value
Accept pipeline input? false
Accept wildcard characters? false
-criteria <String>
A string searched in all relevant object attributes
Required? false
Position? 25
Default value
Accept pipeline input? false
Accept wildcard characters? false
-FullResultsOutput [<SwitchParameter>]
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
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
OUTPUTS
System.Management.Automation.PSObject
RELATED LINKS