Set-IscsiServerTarget

Windows Server 2012 R2 and Windows 8.1

Set-IscsiServerTarget

Modifies settings for the specified iSCSI target.

구문

Parameter Set: TargetName
Set-IscsiServerTarget [-TargetName] <String> [-Chap <PSCredential> ] [-ComputerName <String> ] [-Credential <PSCredential> ] [-Description <String> ] [-Enable <Boolean> ] [-EnableChap <Boolean> ] [-EnableReverseChap <Boolean> ] [-EnforceIdleTimeoutDetection <Boolean> ] [-FirstBurstLength <Int32> ] [-InitiatorIds <InitiatorId[]> ] [-MaxBurstLength <Int32> ] [-MaxReceiveDataSegmentLength <Int32> ] [-PassThru] [-ReceiveBufferCount <Int32> ] [-ReverseChap <PSCredential> ] [-TargetIqn <Iqn> ] [ <CommonParameters>]

Parameter Set: InputObject
Set-IscsiServerTarget -InputObject <IscsiServerTarget> [-Chap <PSCredential> ] [-ComputerName <String> ] [-Credential <PSCredential> ] [-Description <String> ] [-Enable <Boolean> ] [-EnableChap <Boolean> ] [-EnableReverseChap <Boolean> ] [-EnforceIdleTimeoutDetection <Boolean> ] [-FirstBurstLength <Int32> ] [-InitiatorIds <InitiatorId[]> ] [-MaxBurstLength <Int32> ] [-MaxReceiveDataSegmentLength <Int32> ] [-PassThru] [-ReceiveBufferCount <Int32> ] [-ReverseChap <PSCredential> ] [-TargetIqn <Iqn> ] [ <CommonParameters>]




자세한 설명

The Set-IscsiServerTarget cmdlet modifies settings for the iSCSi target and returns the corresponding iSCSI Target object if the PassThru parameter is specified.

매개 변수

-Chap<PSCredential>

Specifies the settings for CHAP user name and secret. This parameter should be used in combination with the EnableChap parameter if the Chap is not enabled.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-ComputerName<String>

Specifies the computer name, or IP address, of the remote computer, if this cmdlet is run on a remote computer.
Specifies the cluster resource group network name, or cluster node name, if this cmdlet is run on a cluster configuration.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-Credential<PSCredential>

Specifies the credentials when connecting to a remote computer.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-Description<String>

Specifies a description for the iSCSI target.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-Enable<Boolean>

Determines whether the specified iSCSI target is enabled or disabled.
If this parameter is set to True is specified, then the target is enabled. If the target is already enabled, no action occurs.
If this parameter is set to False is specified, then the target is disabled. If the target is already disabled, no action occurs.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-EnableChap<Boolean>

Sets whether CHAP is enabled for the iSCSI target.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-EnableReverseChap<Boolean>

Sets whether reverse CHAP is enabled for the iSCSI target.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-EnforceIdleTimeoutDetection<Boolean>

Sets whether to enforce idle timeout detection.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-FirstBurstLength<Int32>

Sets the length of the first burst.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-InitiatorIds<InitiatorId[]>

Specifies the iSCSI initiator identifiers (IDs) to which the iSCSI target is assigned.
To assign a LUN or VHD to an iSCSI initiator, an iSCSI target is first created. After the target is assigned to the initiator, then a LUN is associated with the target.
The format of this parameter is IdType:Value.
이 매개 변수에 허용되는 값은 다음과 같습니다. DNSName, IPAddress, IPv6Address, IQN, or MACAddress.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-InputObject<IscsiServerTarget>

Accepts an iSCSI target object from the input pipeline.


별칭

없음

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-MaxBurstLength<Int32>

Specifies the maximum burst length.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-MaxReceiveDataSegmentLength<Int32>

Specifies the maximum receiver data segment length.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-PassThru

작업하고 있는 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-ReceiveBufferCount<Int32>

Specifies the receiver buffer count.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-ReverseChap<PSCredential>

Sets the reverse CHAP user name and secret. This parameter should be used in combination with the EnableReverseChap parameter if the Reverse Chap is not enabled.


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 허용 여부

false

-TargetIqn<Iqn>

Specifies the target iSCSI Qualified Name (IQN).


별칭

없음

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-TargetName<String>

Specifies the name of the iSCSI target.
Note: The target name cannot be changed here. This parameter can be used to filter out the iSCSI Target objects.


별칭

없음

필수 여부

true

위치

1

기본값

없음

파이프라인 입력 적용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(http://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

  • Microsoft.Iscsi.Target.Commands.IscsiServerTarget

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

  • Microsoft.Iscsi.Target.Commands.IscsiServerTarget

예제

EXAMPLE 1

This example removes all of the initiators that are associated with the target named Test.


PS C:\> Set-IscsiServerTarget -TargetName Test -InitiatorId @()

EXAMPLE 2

This example sets the description for a target named TargetOne to Target for initiator Appsvr.


PS C:\> Set-IscsiServerTarget –TargetName "TargetOne" -Description "Target for initiator Appsvr"

EXAMPLE 3

This example enables and sets the forward CHAP on a target named T1 with the credentials user and password.


 

PS C:\> $password = ConvertTo-SecureString -String "passwordpass" -AsPlainText -Force

 

PS C:\> $chap = New-Object -ComObject System.Management.Automation.PSCredential("user", $password)

 

PS C:\> Set-IscsiServerTarget –TargetName "T1" -EnableChap $true -Chap $chap

EXAMPLE 4

This example assigns more IDs to the same target.


PS C:\> Set-IscsiServerTarget -TargetName Test -InitiatorId @("IPAddress:10.10.1.10","IPAddress:10.10.1.11")

EXAMPLE 5

This example assigns the target to all initiators that attempt to connect to it. Because no validation is performed the iSCSI target when an initiator makes a connection, be very cautious when using this configuration. It is most useful when troubleshooting connection issues ─ removing the possibility of Target-Initiator assignment errors.


PS C:\> Set-IscsiServerTarget -TargetName Test -InitiatorId "IQN:*"

관련 항목

커뮤니티 추가 항목

추가
표시: