Grant-SCIPAddress
지정된 주소 풀에서 고정 또는 가상 IP 주소를 할당합니다.
Syntax
Grant-SCIPAddress
[-VMMServer <ServerConnection>]
-StaticIPAddressPool <StaticIPAddressPool>
-GrantToObjectType <AllocatedToObjectType>
[-IPAddress <String>]
[-GrantToObjectID <Guid>]
[-Description <String>]
[-ExplicitRevokeRequired <Boolean>]
[-DisableReconcile <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Grant-SCIPAddress
[-NetworkController <VirtualSwitchExtensionManager>]
[-UserRole <UserRole>]
[-VMMServer <ServerConnection>]
-IPAddress <String>
[-Description <String>]
[-PublicIPAddress]
[-Owner <String>]
[-ExplicitRevokeRequired <Boolean>]
[-DisableReconcile <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Description
Grant-SCIPAddress cmdlet은 지정된 주소 풀에서 고정 IP 및 가상 IP 주소를 할당합니다.
특정 IP 주소를 부여하려면 IPAddress 매개 변수를 사용합니다. 그렇지 않으면 VMM(Virtual Machine Manager)이 주소 풀에서 IP 주소를 선택합니다.
예제
예제 1: IP 주소 할당
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $vNICs = $VM.VirtualNetworkAdapters
PS C:\> $IPPool = Get-SCStaticIPAddressPool -Name "Production IP Address Pool"
PS C:\> Grant-SCIPAddress -StaticIPAddressPool $IPPool -GrantToObjectType VirtualNetworkAdapter -GrantToObjectID $vNICs[0].ID -Description $VM.Name첫 번째 명령은 VM01이라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.
두 번째 명령은 가상 머신 VM01에 대한 가상 네트워크 어댑터 개체를 가져오고 $vNICs 변수에 개체를 저장합니다.
세 번째 명령은 프로덕션 IP 주소 풀이라는 고정 IP 주소 풀 개체를 가져오고 개체를 $IPPool 변수에 저장합니다.
마지막 명령은 $IPPool 저장된 고정 IP 주소 풀의 IP 주소를 $vNICs 저장된 첫 번째 가상 네트워크 어댑터에 할당하고 할당된 IP 주소에 대한 설명으로 VM01을 제공합니다.
매개 변수
-Description
개체에 대한 설명을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableReconcile
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExplicitRevokeRequired
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GrantToObjectID
할당된 IP 주소 또는 MAC 주소가 할당된 개체의 ID를 지정합니다.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GrantToObjectType
할당된 IP 주소 또는 가상 IP 주소가 할당되는 AllocatedToObjectType의 값을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- VirtualNetworkAdapter
- VIP
- HostNetworkAdapter
- LoadBalancerConfiguration
- VirtualMachine
- HostCluster
| Type: | AllocatedToObjectType |
| Accepted values: | VirtualNetworkAdapter, VIP, HostNetworkAdapter, LoadBalancerConfiguration, VirtualMachine, HostCluster, VMSubnet, NetworkService, NATConnection, NetworkGateway, StorageArray, VMNetworkGateway, None |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IPAddress
IPv4 또는 IPv6 주소를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
작업 진행률을 추적하여 이 매개 변수로 이름이 지정된 변수에 보관하도록 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NetworkController
네트워크 컨트롤러를 지정합니다.
| Type: | VirtualSwitchExtensionManager |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
사용자 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자를 대신하여 작동합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
사용자 역할을 지정합니다. 사용자 역할을 가져오려면 Get-SCUserRole cmdlet을 사용합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자 역할을 대신하여 작동합니다.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Owner
유효한 도메인 사용자 계정의 형태로 VMM 개체의 소유자를 지정합니다.
- 예제 형식:
-Owner "Contoso\PattiFuller" - 예제 형식:
-Owner "PattiFuller@Contoso"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
이 작업을 트리거한 PRO 팁(성능 및 리소스 최적화 팁)의 ID를 지정합니다. 이 매개 변수를 사용하면 PRO 팁을 감사할 수 있습니다.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublicIPAddress
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StaticIPAddressPool
고정 IP 주소를 할당할 수 있는 IP 주소 풀을 지정합니다.
| Type: | StaticIPAddressPool |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRole
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
VMM 서버 개체를 지정합니다.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
출력
CloudDRPairingInfoData
이 cmdlet은 CloudDRPairingInfoData 개체를 반환합니다.
참고
- 이 cmdlet에는 Get-SCStaticIPAddressPool cmdlet을 사용하여 검색할 수 있는 VMM 고정 IP 주소 풀 개체가 필요합니다.