|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Test-NaCifsName
NAME
Test-NaCifsName
SYNOPSIS
Determines whether or not a particular CIFS server name is already in use on
the network and a specified domain.
SYNTAX
Test-NaCifsName [-CifsServer] <String> [-AuthType] <String> [-Domain] <Strin
g> [-DCAddress <String>] [-User <String>] [-Password <String>] [-Credential
<PSCredential>] [-Controller <NaController>] [<CommonParameters>]
DESCRIPTION
Determines whether or not a particular CIFS server name is already in use on
the network and a specified domain.
PARAMETERS
-CifsServer <String>
The NetBIOS CIFS server name that will be verified. Example: cifsserver
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-AuthType <String>
The authentication style that will be used in a subsequent call to Set-N
aCifs. These styles are subject to change in a future release. Possible
values: ad, nt4, workgroup, passwd Note: The Domain, User and Password f
ields are optional unless AuthType is ad.
Required? true
Position? 2
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Domain <String>
The name of the domain that the CIFS server will join. Examples: cifsdom
ain, cifs.domain.com
Required? true
Position? 3
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-DCAddress <String>
If this value is defined, CIFS will attempt to communicate with the doma
in controller directly using this address. Note: This information is onl
y used when AuthType is 'nt4'.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-User <String>
The name of a domain user that has the ability to add the CIFS server to
the domain given in Domain. Examples: username (assumes Domain is the u
ser's domain), cifsdomain\username, cifs.domain.com\username
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Password <String>
The password for user.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Credential <PSCredential>
Credentials of a domain user that has the ability to add the CIFS server
to the domain given in Domain. This user is assumed to be a part of th
e domain supplied by the -Domain parameter.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".
INPUTS
OUTPUTS
DataONTAP.Types.Cifs.CifsSetupVerifyNameInfo
NOTES
Category: cifs
API: cifs-setup-verify-name
-------------- Example 1 --------------
C:\PS>Test-NaCifsName benson ad rtprre.testdomain -User Administrator -Passw
ord p@ssw0rd | fl
Check whether the server name 'benson' is in use in the 'rtprre' domain.
IsInUse : True
IsInDomain : True
RELATED LINKS
Set-NaCifs
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|